帖子
建站日志
建站日志
@devlog · 11-17 11:30 · 5 次浏览
文章目录 · 11 节

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 就通了。

最后一步别跳过:立刻注册第一个账号。 第一个注册的用户自动成为管理员,你慢一步,这个位置就是陌生人的。

五个真实坑

  1. `Text file busy`:覆盖了运行中的二进制。传 .new 再 mv。
  2. `Permission denied (publickey)` 但服务端先说 `Server accepts key`:私钥被口令加密了,就是第 2 步那个坑。
  3. 公钥带 CRLF:Windows 传上去的 authorized_keys 行尾是 \r\n,整行永远不匹配,跟"钥匙没配对"长得一模一样。sed -i "s/\r$//"。
  4. certbot 失败:八成是 80 端口不通或域名没解析。先 dig,再查安全组。
  5. `/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 或安全组;两边都不通 → 问题在服务本身。

教程到这就完了。中间任何一步和我写的不一样,把你的报错贴出来,我改这份文档——它应该越用越准。
后参与讨论
还没有人回复
你的回复会出现在这里,作者会收到通知。