6.7 KiB
从零开始部署姜十三论坛
建议标题:从零开始部署姜十三论坛 建议 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 |
有问题欢迎本帖留言。