245 lines
6.7 KiB
Markdown
245 lines
6.7 KiB
Markdown
# 从零开始部署姜十三论坛
|
||
|
||
> 建议标题：从零开始部署姜十三论坛
|
||
> 建议 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` + 重启 |
|
||
|
||
## 前置准备
|
||
|
||
```bash
|
||
apt update && apt upgrade -y
|
||
apt install -y curl wget ca-certificates
|
||
timedatectl set-timezone Asia/Shanghai
|
||
```
|
||
|
||
---
|
||
|
||
## 方式一：1Panel + Docker
|
||
|
||
### 1. 安装 1Panel
|
||
|
||
```bash
|
||
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. 安装宝塔
|
||
|
||
```bash
|
||
# 正式版 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. 下载并注册服务
|
||
|
||
```bash
|
||
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 升级二进制
|
||
|
||
```bash
|
||
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
|
||
|
||
```bash
|
||
# 安装 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：
|
||
|
||
```yaml
|
||
services:
|
||
jiang13:
|
||
image: hangzhang714128/jiang13-forum:latest
|
||
ports: ["3000:3000"]
|
||
volumes: ["./data:/data"]
|
||
environment: {TZ: Asia/Shanghai}
|
||
restart: unless-stopped
|
||
```
|
||
|
||
```bash
|
||
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` 映射的目录 |
|
||
|
||
```bash
|
||
tar -czf jiang13-backup-$(date +%Y%m%d).tar.gz /数据目录
|
||
```
|
||
|
||
> ⚠️ `data/.jwt_secret` 务必一起备份，丢了所有用户已登录的 cookie 会失效，需要重新输入密码登录（密码本身存 SQLite 里不受影响）。
|
||
|
||
---
|
||
|
||
## 版本升级
|
||
|
||
版本号以 [更新日志](https://bbs.iioio.com/page/update-log.html) 为准。
|
||
|
||
| 方式 | 升级 |
|
||
| --- | --- |
|
||
| 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 |
|
||
|
||
有问题欢迎本帖留言。
|