20 分钟把论坛跑起来:我踩过的坑都标在路上了
这是我自己的部署流程,不是抄来的通用教程。它在这台机器上跑过三次,每次发版我都按它走一遍。
你需要准备的四样
一台 2 核 2G / Ubuntu 22.04 的服务器(1 核 1G 能跑,但编译和 nginx 同时跑会很难受)、一个
已备案的域名、本地装了 Go、会用 SSH。
第 1 步:买机器(3 分钟)
镜像选 Ubuntu 22.04,规格 2 核 2G,磁盘 40G ESSD Entry,带宽 3M 固定。
安全组放行 22 / 80 / 443——少了 80,证书续期会断,90 天后整个站挂掉。
第 2 步:生成本机密钥(2 分钟)
Windows 用户注意:
ssh-keygen -N '""' 里的
"" 会被当成两个字面双引号,生成出来是一把
加密私钥。服务端日志先
Server accepts key 再
Permission denied,看报错完全猜不到是口令问题。要用 cmd:
cmd /c "ssh-keygen -t ed25519 -C admxn -f %USERPROFILE%\.ssh\id_ed25519_admxn -N """
判据:私钥第二行有
AAAAAARub25l 才是空口令。
第 3 步:跑初始化脚本(3 分钟)
scp -i ~/.ssh/id_ed25519_admxn setup-quickstart.sh root@你的IP:/root/
ssh -i ~/.ssh/id_ed25519_admxn root@你的IP 'bash /root/setup-quickstart.sh 你的域名'
脚本做七件事:装 nginx 与 certbot;建
deploy 普通用户(带 sudo,日常不用 root 直连);建
/srv、
/var/lib、
/var/backups 三个目录;装 systemd 单元,
服务只监听 127.0.0.1:8090;装 Nginx 反代(先只开 80,证书没签时写 ssl 配置会让 nginx 起不来);配 ufw 只开 22/80/443 与 fail2ban;装备份(每天 03:30)和存活检查(每 5 分钟,非 200 自动重启)的定时任务。
第 4 步:编译上传(3 分钟)
在你自己电脑上:
GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build -trimpath -ldflags "-s -w" -o dist/admxn-feed .
scp -i ~/.ssh/id_ed25519_admxn dist/admxn-feed root@你的IP:/srv/admxn-feed/admxn-feed.new
ssh -i ~/.ssh/id_ed25519_admxn root@你的IP "chown deploy:deploy /srv/admxn-feed/admxn-feed.new && chmod 755 /srv/admxn-feed/admxn-feed.new && mv /srv/admxn-feed/admxn-feed.new /srv/admxn-feed/admxn-feed && systemctl restart admxn-feed"
先传 `.new` 再 `mv`:直接覆盖正在运行的二进制会报
Text file busy。
第 5 步:解析域名(2 分钟,生效要等几分钟)
@ 和
www 各一条 A 记录指向公网 IP。等
dig 你的域名 能看到 IP 再往下走——解析没生效时 certbot 不是"可能失败",是必然失败。
第 6 步:开 HTTPS(2 分钟)
certbot --nginx -d 你的域名 -d www.你的域名 --agree-tos -m 你的邮箱 --redirect
第 7 步:验收(1 分钟)
curl -s -o /dev/null -w 'home=%{http_code}\n' http://127.0.0.1:8090/
curl -s -o /dev/null -w 'logo=%{http_code}\n' https://你的域名/static/logo.svg
两个都是 200 就通了。
最后一步别跳过:立刻注册第一个账号。 第一个注册的用户自动成为管理员,你慢一步,这个位置就是陌生人的。
五个真实坑
- `Text file busy`:覆盖了运行中的二进制。传
.new 再 mv。 - `Permission denied (publickey)` 但服务端先说 `Server accepts key`:私钥被口令加密了,就是第 2 步那个坑。
- 公钥带 CRLF:Windows 传上去的
authorized_keys 行尾是 \r\n,整行永远不匹配,跟"钥匙没配对"长得一模一样。sed -i "s/\r$//"。 - certbot 失败:八成是 80 端口不通或域名没解析。先
dig,再查安全组。 - `/static/logo.svg` 404 但本地正常:本地跑的是磁盘上的
static/,服务器跑的是编译进二进制的资源。新增静态文件必须同步 embed 列表,否则线上只有它一个文件不存在——我为这一个 404 追了一晚上。
上不去时按这个顺序查
systemctl status admxn-feed # 服务活着吗
journalctl -u admxn-feed -n 50 # 为什么死的
curl -s -o /dev/null -w '%{http_code}\n' http://127.0.0.1:8090/ # 程序本身通不通
nginx -t # 反代配置对不对
127.0.0.1:8090 通、外网不通 → 问题在 Nginx 或安全组;两边都不通 → 问题在服务本身。
教程到这就完了。中间任何一步和我写的不一样,把你的报错贴出来,我改这份文档——它应该越用越准。