Files
jiang13-forum/docs/site-posts/deployment-guide.md

6.7 KiB
Raw Permalink Blame History

从零开始部署姜十三论坛

建议标题:从零开始部署姜十三论坛 建议 slug:deploy 建议操作:发布后设为「置顶」 复制正文时:从下方第一个 --- 之后开始粘贴


为什么选姜十三

单二进制 + 内置 SQLite,不需要 MySQL、PHP、Redis。面板(宝塔 / 1Panel)只是帮你更方便地管理,不是必须的。

服务器选型

部署方式 CPU 内存 磁盘
纯二进制(无面板) 1 核 512MB 10GB SSD
二进制 + 宝塔 1 核 1GB 20GB SSD
Docker + 1Panel 2 核 2GB 40GB SSD

推荐 Debian 12 / Ubuntu 22.04。建议直接上 2 核 2G。

部署方式对比

1Panel + Docker 宝塔 + 二进制 纯命令行 Docker
适合 新手 / 还要跑其他容器 习惯宝塔 / 只跑这一个 熟悉 Linux / 资源紧张
资源占用 较高(自带 Docker) 低 最低
HTTPS 面板一键 面板一键 Caddy / certbot
备份 面板计划任务 面板计划任务 tar 打包
升级 面板点一下 替换二进制 docker pull + 重启

前置准备

apt update && apt upgrade -y
apt install -y curl wget ca-certificates
timedatectl set-timezone Asia/Shanghai

方式一:1Panel + Docker

1. 安装 1Panel

curl -sSL https://resource.fit2cloud.com/1panel/package/v2/quick_start.sh \
  -o quick_start.sh && bash quick_start.sh
  • 安装目录:默认 /opt
  • 是否装 Docker:y(必须)
  • 面板端口 / 安全入口 / 账号密码自定义,记好

安全组放行设置的端口,然后浏览器打开面板。

2. 启动姜十三

1Panel 面板 → 容器 → 创建:

字段 值
镜像 hangzhang714128/jiang13-forum:latest
端口 3000:3000
数据卷 主机目录 → 容器内 /data
重启策略 unless-stopped

浏览器访问 http://IP:3000 → 首个注册用户自动成为管理员。

若容器报 permission denied:chown -R 1000:1000 /数据目录


方式二:宝塔 + 二进制

1. 安装宝塔

# 正式版 13.0.0(含 AI,需绑定账号)
if [ -f /usr/bin/curl ];then curl -sSO https://download.bt.cn/install/install_panel.sh;else wget -O install_panel.sh https://download.bt.cn/install/install_panel.sh;fi;bash install_panel.sh KZOqff1mn

# 稳定版 12.0.0(纯净、免绑定)
url=https://download.bt.cn/install/installStable_12.sh;if [ -f /usr/bin/curl ];then curl -sSO $url;else wget -O installStable_12.sh $url;fi;bash installStable_12.sh 5x59vxy56

安全组放行随机端口,浏览器打开(自签名证书提示 → 高级 → 继续前往)。

2. 下载并注册服务

mkdir -p /opt/jiang13 && cd /opt/jiang13
# 版本号以更新日志为准:https://bbs.iioio.com/page/update-log.html
wget -O jiang13 https://git.iioio.com/freefire/jiang13-forum/releases/download/v1.1.8/jiang13_v1.1.8_linux-amd64
chmod +x jiang13

# 注册为 systemd 服务(install 创建 unit 文件,start 启动,enable 开机自启)
./jiang13 -service install
./jiang13 -service start
systemctl enable jiang13

# 日常管理
./jiang13 -service status    # 查看状态
./jiang13 -service restart   # 重启

# 验证
curl http://127.0.0.1:3000/health

只是临时跑一下?直接 ./jiang13 前台启动即可,Ctrl+C 停止,不用 install。

2.1 升级二进制

cd /opt/jiang13
./jiang13 -service stop
wget -O jiang13.new https://git.iioio.com/freefire/jiang13-forum/releases/download/v新版本/jiang13_v新版本_linux-amd64
mv jiang13.new jiang13 && chmod +x jiang13
./jiang13 -service start

3. 宝塔反代 + SSL

网站 → 添加站点(域名,PHP 选纯静态)→ 反向代理(目标 http://127.0.0.1:3000)→ SSL → Let's Encrypt 一键签发 → 强制 HTTPS。


方式三:纯 Docker

# 安装 Docker
bash <(curl -sSL https://linuxmirrors.cn/docker.sh)

# 启动姜十三
docker run -d \
  --name jiang13 \
  -p 3000:3000 \
  -v /opt/jiang13-data:/data \
  --restart unless-stopped \
  hangzhang714128/jiang13-forum:latest

或用 docker compose:

services:
  jiang13:
    image: hangzhang714128/jiang13-forum:latest
    ports: ["3000:3000"]
    volumes: ["./data:/data"]
    environment: {TZ: Asia/Shanghai}
    restart: unless-stopped
docker compose up -d

HTTPS 用 Caddy 最省心:

bbs.yourdomain.com {
    reverse_proxy 127.0.0.1:3000
}

Caddy 自动申请 Let's Encrypt。


域名 + HTTPS

域名服务商添加 A 记录:bbs → 服务器公网 IP。

方式 HTTPS 操作
1Panel 网站 → 创建 → 反向代理 → SSL → Let's Encrypt
宝塔 同上
纯 Docker Caddy 自动 / Nginx + certbot

数据备份

所有数据(SQLite + 上传 + JWT 密钥)都在一个目录里,备份 = 复制目录。

方式 数据目录
1Panel Docker 你映射的宿主机目录
宝塔二进制 二进制同目录下 data/
纯 Docker -v 映射的目录
tar -czf jiang13-backup-$(date +%Y%m%d).tar.gz /数据目录

⚠️ data/.jwt_secret 务必一起备份,丢了所有用户已登录的 cookie 会失效,需要重新输入密码登录(密码本身存 SQLite 里不受影响)。


版本升级

版本号以 更新日志 为准。

方式 升级
1Panel 容器列表 → 选中 → 镜像更新
docker compose docker compose pull && docker compose up -d
二进制 见上方「2.1 升级二进制」

升级前先备份:tar -czf backup.tar.gz /数据目录


面板常用命令

操作 宝塔 1Panel
菜单 bt 1pctl
查入口 / 密码 bt default 1pctl user-info
改密码 bt 14 1pctl update password
重启面板 bt restart —

常见问题

Q:面板 / 网站打不开? 安全组有没有放行对应端口?netstat -tlnp | grep 端口 看服务在不在监听。

Q:宝塔 vs 1Panel 怎么选? 只跑姜十三 → 宝塔 + 二进制(省资源);还要跑别的 → 1Panel。

Q:支持邮件 / SSO 吗? 邮件 SMTP 和 OIDC SSO 都在管理后台 → 系统设置里配置。

Q:源码编译? 见项目 README。推荐用预编译包。

链接

项目 地址
在线演示 https://bbs.iioio.com/
更新日志 https://bbs.iioio.com/page/update-log.html
Docker Hub hangzhang714128/jiang13-forum
预编译下载 https://git.iioio.com/freefire/jiang13-forum/releases

有问题欢迎本帖留言。