Content
本文面向第一次接触 Serino（[项目地址及效果展示](https://github.com/aerisun/serino)） 的朋友，目标是从一台新服务器开始，引导用户部署、登录、基础配置并开始使用，然后一步步了解进阶与高级功能
部署
1. 拥有一台服务器（难度中，耐心 +++）
准备一台可联网的 Ubuntu/Debian Linux 服务器 ( 2 核 2 G 绰绰有余 )，获取渠道可以是 [阿里云](https://www.aliyun.com/product/ecs)，[腾讯云](https://cloud.tencent.com/product/lighthouse)。如果仅仅想要免费体验，学校 Linux 俱乐部提供的 [Clab](https://clab.pku.edu.cn/) 也可以！
如果是公网机器，推荐绑定域名（若机器在大陆，进一步追求稳定合法，还需备案）！
:::details{title="你需要提前确认："}
- 系统支持 systemd（一般都有）
- 当前用户有 root 或 sudo 权限（一般都有）
- 服务器可以访问互联网（能访问中国互联网就行，Clab 可能需要使用 clabcli connect 联网）
- 阿里云和腾讯云服务器需要在管理台:underline[手动放开 80 和 443 端口]！且保证没有被其它服务占用（如果之前运行过对外服务，请检查是否占用）
- 如果使用域名访问，域名已经解析到这台服务器（没有域名，可以先使用 IPv4 模式部署）
:::
2. 一键安装部署（难度极低，等待安装成功即可）
在服务器终端执行：
```bash
curl -fsSL https://install.aerisun.top/serino/install.sh | bash
```
1. 安装器会让你选择访问方式：
- 域名模式：推荐生产使用， 安装器会自动处理好反向代理和 SSL 证书！(如果检查域名与服务器 IP 不一致，可能是代理干扰，确认无误可以继续)
- 公网 IPv4 模式：适合没有域名但需要公网访问的场景。
- 内网 IPv4 模式：适合校园网、实验环境、Tailscale 或只在局域网访问的场景。
2. 安装过程中会要求设置管理台账号和密码，这个用于进入网站管理台！
3. 静待安装成功......
:::details{title="生产部署的主要目录如下："}
| 位置 | 用途 |
| --- | --- |
| /opt/serino | 程序、安装器和脚本 |
| /etc/serino/serino.env | 生产环境配置 |
| /var/lib/serino | 数据库、媒体文件、密钥和运行数据 |
| /var/log/serino | 运维日志 |
| /var/backups/serino | 安装和升级备份 |
| /usr/local/bin/sercli | 运维命令入口 |
:::
基础配置与上手使用
首次进入后台
https://你的域名/admin/
1. 基础配置（成为你的小站）
1. 修改「基本配置 - 个人资料」，查看描述，与网站前端对应着修改
2. 在「基本配置 - 社交链接」设置社交账号
3. 在「简历」设置简历内容
4. 在「友链 - 申请说明」配置申请说明文案
5. 在「访客 - 基础配置 - 管理员认证」中开启 “邮箱绑定”，绑定你的邮箱。后面在网站前端通过这个邮箱登录，获得站长标识
2. 日常使用
1. 在「内容 - 文章/日记/碎碎念/文摘」新建一篇内容看看
- markdown 语法参考 [这里](https://aerisun.top/posts/serino-markdown)
- 写的差不多可以点击「真实页面预览」预览发布后的页面样式
- 浏览器会缓存最近一份编辑界面。 eg ：如果编辑文章中不慎退出，请立马登回，点击进入正在编辑的文章/新建文章可以恢复刚刚正在编辑的内容
- 只有 发布/保存私密 之后，内容才会真正落库。
2. 在「友链 - 朋友们」设置友链
3. 「审核」可以对访客的评论、留言、日记查看申请进行管理（是否需要审核可以在「基本配置 - 评论系统」中设置，日记是否公开在「拓展配置 - 功能开关 - 自定义」里面配置）
4. 「访客 - 访客监控」可以查看访问记录
5. 「资源」可以查看/管理网站中的资源（公开资源有外部可访问链接，可设置 slug 挂载在 /media 下）
6. 「审计日志 - 配置历史」随时回退配置，清除误配置
7. 若有更新，管理台上方会有提示，一键更新系统
8. （高级）服务器终端执行 sercli -h 查看全部系统命令，sercli uninstall 彻底卸载系统😞
推荐进阶设置
1. 对象存储和 OSS 加速（难度低，耐心 ++，非常推荐）
「拓展配置 -> 对象存储」
在 [滨纷云<免费>](https://beta.bitiful.com/) 中配置并获取以下信息填写：
- Bucket。
- Endpoint。
- Region。
- 媒体域名或 CDN 域名。
- Access Key。
- Secret Key。
- 可选的 CDN 防盗链密钥。
连通性测试后，启用 OSS 加速
>开启后：
>1. 资源上传和下载会优先使用对象存储，大大加快访问速度，减小服务器网络压力！
>2. 服务器本地仍会异步同步文件，不必担心文件丢失
>3. 首次启用 OSS 加速会立即开始同步资源文件
2. 邮箱配置与订阅邮件（难度高，耐心 ++++，较推荐）
「拓展配置 -> 邮箱配置」
在 [mailgun<免费>](https://app.mailgun.com/) 中配置并获取以下信息填写：
- SMTP 主机
- SMTP 端口
- 发件邮箱（别用沙盒，绑自己域名）
- SMTP 用户名（别用沙盒，绑自己域名）
- SMTP 密码
测试邮件，保存配置
>恭喜你，解锁：
>
>1. 网站订阅功能，「拓展配置 - 功能开关 - 开启订阅入口」
>2. 评论反馈功能，「拓展配置 - 功能开关 - 开启评论反馈」
3. 建立备份系统（难度中，耐心 +，非常推荐）
「备份」
1. 准备一台 Linux 机器作为备份机
2. 在「设置」页填写备份机 IP 或 tailscale 内网中的主机名
3. 点击检测
4. 如果生成临时命令，到备份机终端执行这条临时命令。
5. 回到后台等待指示
6. 如果设置恢复密码亮起，设置回复密码（一定要记牢，忘记需要重置备份系统）
7. 测试并保存，并开始备份。
>备份功能用于把 Serino 的运行数据利用 SSH 同步到另一台备份机的 serino-backup 用户和 /srv/serino-backups 目录下：
>
>1. 服务器正常运行，在「备份 - 记录」中，服务器可以随时恢复到之前的备份点
>2. 若服务器受灾，在新的服务器上面部署好（全新）网站后，连接备份机器，可以一键同步原有的所有数据和配置，完全恢复如初！！！
4. API 配置（难度低，耐心 +，较推荐）
「拓展配置 -> API配置」
闲鱼几块钱买个 deepseek api，配置好字段，测试，保存。
>恭喜解锁：
>
>1. 日记中的诗句联想
>2. Agent 系统的大脑（还不能保证完全稳定调用）
>3. 后续各类内嵌 Agent（开发中）....
5. 拓展认证方式（难度高，耐心 +++++，较推荐）
1. 在「拓展配置 -> 代理设置」中配置代理端口并测试成功，开启 OAuth 走代理。这个意味着你需要在服务器上面配置 [c**sh](https://github.com/MetaCubeX/mihomo)，需要一点耐心，加油！
2. 在「访客 - 基础配置」中绑定 Google 与 Github 账号。请您询问 AI 进行
Client ID， Client Secret 获取与回调绑定。加油，需要一点耐心，没有硬障碍！
3. 进行管理员认证，绑定好身份
4. 「关于系统 - 管理员信息」里面可以开启允许 google/github 登录，可以通过网站前端点击头像进入后台
>很困难，但是恭喜你来到这里：
>1. 用户可以通过 google/github 认证来登录，正规优雅，体验感更好！
>2. 你可以通过网站前端点击头像进入后台，优雅！
高级设置
自行探索
系统仍有不少配置，可以大胆自行探索。「审计日志 -> 配置历史」可以方便的进行配置回撤；「备份 -> 记录」可以进行数据与配置的全量数回撤
MCP 服务
「MCP 服务」
1. 打开 MCP 授权开关
2. 生成 1 个 MCP 访问密钥
3. 密钥权限细节在「MCP 服务 - MCP 权限配置」精细化配置
4. 让 openclaw/codex/claudecode 等 agent 系统拿着密钥，打 https://aerisun.top/api/agent/usage，它就会知道怎么管理这个系统了。然后，说出你的想法.....
Agent 自动化
「Agent」
不太稳定，可以新建一个自己玩玩连线，试试