⚡ 全新安装
reSitesHub 为不同平台提供适配的安装脚本，选择你的平台，复制粘贴即可运行——脚本依次交互式询问实例名称、依赖模式（自动建库 / 已有连接串 / 仅落地文件）、数据库和 Redis 连接、首个管理员账号密码，每一步都给出推荐默认值，直接回车即可，全程不需要提前准备参数文件。
| 操作系统 | 主流发行版均可（Ubuntu / Debian / CentOS / RHEL / Rocky Linux / AlmaLinux 等），满足 glibc 2.35+ 就能跑，不限定具体发行版 |
| 依赖服务 | PostgreSQL 16+ · Redis 7+ · Nginx（可选，安装时交互选择是否自动生成反代配置） |
| 运行时 | 无需额外安装 —— Rust 编译为单二进制文件 |
curl -fsSL https://rssiteshub.ylh.pub/downloads/rssites-install-instance-linux.sh | sudo bash
| 操作系统 | Windows 10 / Windows Server 2019 及以上 |
| 依赖服务 | PostgreSQL 16+ · Redis 7+ · Nginx（可选，安装时交互选择是否自动生成反代配置） |
| 运行时 | 无需额外安装 —— Rust 编译为单二进制文件 |
irm https://rssiteshub.ylh.pub/downloads/rssites-install-bootstrap-windows.ps1 | iex
没有外网访问？下载离线安装包（脚本+二进制+管理后台+默认模板打包在一起，解压后本地运行，无需联网）： Linux 离线包 | Windows 离线包 | macOS / Docker 离线包即将上线
脚本跑完自动生成 config.toml/.env、执行数据库迁移、安装默认模板、创建首个平台管理员账号；可以选择立即注册为系统服务并开机自启，也可以先跳过，之后用实例目录下自动生成的 register-service 脚本随时补注册。
📦 升级安装
已经部署过的实例，不用重新走一遍安装流程——在实例目录下跑一下 update 脚本即可。
cd /path/to/instance && ./update.sh # Windows 下是 .\update.ps1
脚本自动下载校验新版本、单独跑一次数据库迁移确认成功、再把 current 符号链接原子切换到新版本并重启服务——迁移失败和服务起不来分开报，不会混在一起；出问题就把 current 切回旧版本目录，随时能回滚。
❓ 常见问题
安装时提示数据库连不上，怎么排查？
先单独跑一次
rssites verify-config，只校验配置和连通性、不做任何写入——大多数是连接串里的主机名/端口/密码填错，或者 PostgreSQL 没开放对应网络访问。Windows 上注册成服务后启动不了？
Windows 服务管理器（SCM）拉起进程时默认工作目录是
C:\Windows\System32，不是部署目录——确认 register-service 脚本注册时带上了 --working-dir 参数指向实际部署路径，这是 Windows 独有的坑，Linux/systemd 不受影响。忘记了平台管理员密码？
用 CLI 的
rssites user reset-password 命令直接在服务器本地重置，不走网络接口，也不需要"忘记密码"邮件流程（本来也没接外部身份系统）。升级后服务起不来？
先看是不是迁移那一步失败了——升级脚本把"迁移"和"重启服务"分成两步，日志分得开，照着报错信息处理完迁移问题再重启，不要跳过迁移直接强行起服务。
域名绑定了，但是访问不到？
检查有没有跑过
bind-primary-domain（或者在后台"域名管理"里手动绑定过），以及 Nginx 配置目录和 reload 命令是不是按实际路径配置对了——这两步任何一步漏了，域名解析对了也访问不到。服务器没有外网访问，脚本下载不下来？
用离线安装包——脚本、二进制、管理后台、默认模板打包在一起，解压后本地运行，全程不需要联网（当前只有 Linux/Windows 离线包，见上方链接）。