快速开始：从零把站开起来
这篇是给「第一次建站、会复制粘贴命令但不懂内部原理」的站长看的。照着做就能跑通，不用先理解底层。遇到不懂的词，翻 术语小词典。
🚀 最无脑路径（强烈推荐新手先看）
如果你只想「一条命令把站起起来，不想懂原理」，直接用官方无脑脚本
scripts/quick-deploy.sh：bash# 方式一：已装好 Docker，一行搞定 curl -fsSL https://github.com/gntv456/FluxTorrent/raw/master/scripts/quick-deploy.sh | sudo bash # 方式二：连 Docker 都没装，让脚本顺手装（仅 Ubuntu/Debian 测过） curl -fsSL https://github.com/gntv456/FluxTorrent/raw/master/scripts/quick-deploy.sh | sudo bash -s -- --install-docker脚本会自动帮你：克隆仓库 → 随机生成三个密钥 →
docker compose up -d起栈 → 跑健康检查 → 告诉你下一步去http://服务器IP:3000/setup。 跑完别关页面，直接跳到下方「第 2 步」走网页向导即可。想看每行在干嘛、或要配域名 HTTPS，再往下读这篇和 建站手把手教程。 ⚠️ 脚本只是把「服务器侧准备」跑完，网页安装向导（四步）和域名 HTTPS 仍需你手动做，教程里都有。
一句话先说清
装好 Docker → 跑一行命令把服务起起来 → 浏览器打开 /setup 填个安装向导 → 改 3 处关键设置 → 开门放用户进来。全程约 10 分钟，大部分时间在等镜像下载，真正动手的没几分钟。
想要逐屏、带每一步点哪填什么的图文教程？直接看 建站手把手教程——本篇是速通版，那篇是手把手版。
TL;DR（赶时间看这版）
- 准备一台装了 Docker 和 git 的服务器（Linux 或 Windows 都行）。
- 复制运行下面“第 1 步”的命令，起好 6 个服务。
- 浏览器打开
http://你的服务器IP:3000/setup，填完向导。 - 改 3 处设置：把 announce 地址改成公网域名、填好邮件、确认注册方式。
- 发邀请码或直接开放注册，放用户进来。
你需要准备什么
- 一台服务器（Linux 或 Windows Server 均可），能装 Docker。
- 一个终端（命令行窗口）。
- 大约 10 分钟，以及能访问服务器 IP 的浏览器。
公网部署（域名、HTTPS、反代）不在本篇——跑通本地访问后，专门看 域名部署教程 一步步配。
第 1 步：把服务起起来
做什么：把整套站点（数据库、网站、后台接口、tracker 等 6 个模块）一次性拉起来。
为什么：我们这套站点是“容器化”交付的，你不用自己装数据库、配环境，一句命令全搞定。
把下面这段整段复制到终端运行：
git clone https://github.com/gntv456/FluxTorrent.git && cd FluxTorrent
# 或用 SSH：git clone git@github.com:gntv456/FluxTorrent.git && cd FluxTorrent
cp docker/.env.example docker/.env
nano docker/.env # 见下方“填什么”；保存 Ctrl+O 回车，退出 Ctrl+X
docker compose -f docker/docker-compose.yml up -d不习惯终端编辑器？两条替代路：① 用宝塔/1Panel 等面板的「文件」管理器，进到
docker/目录双击.env在线编辑（复制.env.example改名.env也在面板里点完成）；② 把docker/.env.example下载到自己电脑，记事本改好三项、文件改名为.env，再上传回服务器的docker/目录。改完再回来跑最后那条docker compose ... up -d。
填什么（用编辑器打开 .env 后，至少有三项必须填，不填服务起不来）：
| 配置项 | 填什么 | 说明 |
|---|---|---|
DB_PASSWORD | 任意强密码 | 数据库密码 |
REDIS_PASSWORD | 任意强密码 | 缓存密码 |
JWT_SECRET | ≥32 位随机串 | 登录令牌密钥。绝不能含 change_me 这几个字，否则生产模式会拒绝启动 |
不会生成随机串？在终端跑
openssl rand -base64 48拿一段粘进去即可。
怎么算成功：命令跑完后，等一两分钟让镜像下载完，然后跑：
curl http://localhost:8080/api/v1/health看到返回 {"status":"up"} 就说明后台接口活了。六个服务会按这个顺序就绪：数据库 → 缓存 → 后台接口（自动建库）→ 工作进程 → tracker。
如果
curl报错或某个模块一直起不来，别慌，看文末「常见问题」。
第 2 步：填安装向导
做什么：在浏览器里完成站点初始化。
为什么：向导会帮你设好站点身份、管理员账号、选好站型。跑完之前，除了登录和改密，其他功能都是锁住的（这叫“装机封锁”，是正常设计不是坏了）。
- 浏览器打开
http://你的服务器IP:3000/setup。 - 选站型：11 种预置（综合/教育/影视/音乐/动漫/电子书/体育/游戏/软件/纪录片/无损）。它决定默认的分类和功能模块。拿不准就选「综合」，以后随时能换。
- 设站点名 + 管理员：系统已预置一个管理员账号
root，初始密码password123。第一次登录会强制你改密码——记好新密码。 - 勾选合规项 → 点完成。向导可以重复打开，不会把站搞乱。
怎么算成功：向导跑完后，再访问站点首页能正常看到界面，且业务接口不再报“封锁”错误。
第 3 步：开站前三项检查（重要）
服务起来了 ≠ 能放用户进来。放人之前，建议先过一遍 开站 checklist。其中三项不做会出事故：
- announce 地址改成公网域名 —— 否则用户下载的种子里写的是内网地址，连不上 tracker，没法做种（新站头号事故）。
- 填好邮件 SMTP —— 否则用户找回不了密码、收不到邀请。
- 确认注册方式 —— 默认是邀请制，要开放注册得手动改。
第 4 步：放用户进来
- 邀请制（默认）：后台「邀请管理」直接发邀请码，或让等级够的用户在
/invites自助生成。 - 开放注册：把注册模式改成
open即可。
到这一步，你的站就正式开张了。
第 5 步：之后长期怎么办
- 每天/每周/每月该做什么、出事先查哪 → 日常运维（建议先收藏这篇）
- 怎么发种子、邀请第一批用户、攒内容 → 运营 playbook
到这一步，你的站就正式开张了。后面怎么运营（促销、考核、反作弊），看 运营 playbook。
常见问题
某个容器起不来 / 一直重启？ 看日志：docker logs <容器名>。最常见的两个原因：.env 里三项必填没填，或 JWT_SECRET 不合规（太短或含 change_me）。
装到一半想重来？docker compose -f docker/docker-compose.yml down -v 会清掉所有数据重来。生产环境千万别乱跑这条，会删库。
装完页面空白 / 一直 404？ 确认你访问的是 :3000（网站），不是 :8080（那是后台接口）。向导没跑完时页面也会是空的，这是正常的。
公网部署、域名、HTTPS 怎么搞？ 看专门的 域名部署教程——DNS 解析、防火墙、Nginx 反代 + Let's Encrypt 证书、把 announce 改成域名，一步一步都有。
更多词看不懂？→ 术语小词典