docs: 精简宝塔部署流程为「上传二进制 + Go项目新建」
1 个文件变更
+28
-37
fangqihang1717@163.com
| •README.md | +28 -37 |
变更内容
diff --git a/README.md b/README.md
index 431b62a..020db2a 100644
--- a/README.md
+++ b/README.md
@@ -143,61 +143,52 @@ CGO_ENABLED=0 GOOS=linux GOARCH=amd64 go build -trimpath -ldflags "-s -w" -o cle
| 面板 | 宝塔 Linux 面板 **7.9.3+**(建议使用最新版本),已安装 **Nginx** |
| 文件 | `clearlove-linux-amd64`(或 arm64),**无需在服务器安装 Go 环境** |
-### 1. 上传二进制并试运行
+### 1. 上传二进制文件
1. 面板左侧「**文件**」→ 进入 `/www/wwwroot/` → 新建目录 `clearlove`
-2. 上传 `clearlove-linux-amd64`,重命名为 `clearlove`
-3. 右键该文件 →「**权限**」→ 设为 `755`(或勾选"所有用户可执行")
-4. 打开面板左侧「**终端**」,执行:
+2. 上传 `clearlove-linux-amd64`(或 arm64),重命名为 `clearlove`
+3. 右键该文件 →「**权限**」→ 设为 `755`(或勾选「所有用户可执行」)
-```bash
-cd /www/wwwroot/clearlove
-chmod +x clearlove
-./clearlove
-```
-
-看到类似输出即表示正常(此时会创建 `data/` 与 `uploads/` 目录):
-
-```
-ClearLove 表白墙 2.0 | 数据目录: data | 上传目录: uploads
-检测到未安装,请访问 http://localhost:16868/install 完成安装向导
-```
-
-按 `Ctrl + C` 退出,接下来交给面板「Go项目」托管运行。
+> 服务器上**不需要安装 Go 环境**,也不用先手动试运行,直接在下一步交给面板托管。
-### 2. 用面板「Go项目」添加并托管
+### 2. 到「Go项目」里新建项目
-面板左侧「**网站**」→ 顶部标签切到「**Go项目**」→「**添加项目**」,按下表填写:
+面板左侧「**网站**」→ 顶部标签切到「**Go项目**」→「**添加项目**」,对照下表填写弹窗即可:
-| 字段 | 填写内容 | 说明 |
+| 弹窗字段 | 填写内容 | 说明 |
|---|---|---|
-| 项目执行文件 | `/www/wwwroot/clearlove/clearlove` | 点右侧文件夹图标选择刚上传的二进制 |
-| 项目名称 | `clearlove` | 仅用于面板标识,**不要使用中文** |
-| 项目端口 | `16868` | 与程序默认端口一致;右侧「放行端口」按需点击(只走反向代理时无需对外放行) |
-| 执行命令 | `clearlove` | 本项目无启动参数,按提示填执行文件名即可 |
-| 环境变量 | 选「**指定变量**」,添加下面两行 | 固定数据目录,避免工作目录不确定导致数据写散 |
+| **项目执行文件** | 选择 `/www/wwwroot/clearlove/clearlove` | 点右侧文件夹图标选中刚上传的二进制 |
+| **项目名称** | `clearlove` | 仅用于面板标识,**不要使用中文** |
+| **项目端口** | `16868` | 程序真实监听端口;勾选右侧「**放行端口**」后可直接用 `IP:16868` 访问 |
+| **执行命令** | `clearlove` | 本项目无启动参数,按提示「默认请输入执行文件名」填写 |
+| 环境变量 | 保持「**无**」 | 数据会生成在项目目录下;如需换路径见下方折叠说明 |
| 运行用户 | `www` | 无特殊需求保持默认 |
| 开机启动 | ✅ 勾选 | 面板自带守护进程,约 120 秒检测一次 |
-| 项目备注 | `表白墙` | 非必填 |
-| 绑定域名 | **留空** | 域名与 HTTPS 交给下一步的「站点 + 反向代理」处理 |
+| 项目备注 | `表白墙` | 非必填,可留空 |
+| 绑定域名 | 留空或填你的域名 | 见下一步;留空时用 `IP:16868` 访问也可 |
+
+<details>
+<summary><b>可选:把数据目录放到其他磁盘</b></summary>
-环境变量(选择「指定变量」后填写):
+「环境变量」选择「**指定变量**」,添加:
```ini
CLEARLOVE_DATA_DIR=/www/wwwroot/clearlove/data
CLEARLOVE_UPLOAD_DIR=/www/wwwroot/clearlove/uploads
```
-> 💡 启动报 `cannot execute binary file`:多为**架构不匹配**(amd64 / arm64 传错)或**没有执行权限**,重新下载对应架构的二进制并 `chmod +x` 即可。
+</details>
+
+> 💡 启动报 `cannot execute binary file`:多为**架构不匹配**(amd64 / arm64 传错)或**没有执行权限**,重新下载对应架构并 `chmod +x` 即可。
> 💡 提示端口被占用:**不要填 80 / 443**,这两个端口已被 Nginx 占用,本项目保持 `16868` 即可。
-> 💡 若已有权限异常,终端执行一次:`chown -R www:www /www/wwwroot/clearlove`。
+> 💡 权限异常时在终端执行一次:`chown -R www:www /www/wwwroot/clearlove`。
-保存后在 Go项目 列表中确认状态为「**运行中**」。
+保存后 Go项目 列表中状态显示「**运行中**」即部署完成,此时即可访问 `http://服务器IP:16868/install` 进入安装向导。
-### 3. 绑定域名 + 反向代理(获得 80 / 443 与 HTTPS)
+### 3.(可选)绑定域名与 HTTPS
-> 服务器安装 Nginx 后 80 / 443 已被占用,因此推荐「Go 项目只监听本机端口,域名交给 Nginx 反代」的方式。
-> 若直接在 Go项目 里填写「绑定域名」,注意面板提示中域名**默认为 80 端口**,会与 Nginx 冲突。
+- **只用 IP 访问**:第 2 步勾选「放行端口」后访问 `http://服务器IP:16868`,接着跳到第 5 步完成安装向导即可。
+- **用域名 + HTTPS**:推荐第 2 步把「绑定域名」**留空**,改用下面的「站点 + 反向代理」方式(这样可以顺带申请证书);若直接在 Go项目 里填写域名,注意面板提示中域名**默认为 80 端口**,会和已占用 80 的 Nginx 冲突。
1. 面板左侧「**网站**」→「**添加站点**」:
- 域名:你的域名,如 `wall.example.com`
@@ -216,14 +207,14 @@ CLEARLOVE_UPLOAD_DIR=/www/wwwroot/clearlove/uploads
3. 保存后直接访问域名,应能看到安装向导(未安装时自动跳转 `/install`)。
-### 4. 申请 HTTPS 证书
+### 4.(可选,接上一步)申请 HTTPS 证书
站点 →「**SSL**」→「**Let's Encrypt**」→ 勾选域名 → 申请;
签发成功后建议开启「**强制 HTTPS**」。程序会自动识别 Nginx 传递的 `X-Forwarded-For` / `X-Real-IP`,封禁与统计拿到的是真实访客 IP。
### 5. 完成安装向导
-浏览器访问 `https://你的域名/install`:
+浏览器访问 `https://你的域名/install`(只用 IP 访问时用 `http://服务器IP:16868/install`):
- **SQLite**:直接下一步(数据文件位于 `/www/wwwroot/clearlove/data/clearlove.db`)
- **MySQL**:先在面板「**数据库**」中新建一个库(如 `clearlove`,字符集 `utf8mb4`),然后在向导中填写