文档修改

2026-05-21 17:51:21 +08:00
parent ab854b2c3c
commit b2823713c9
9 changed files with 126 additions and 53 deletions
@@ -0,0 +1,62 @@
+# 用户端授权配置（crypto_monitor_user）
+
+## 已预置
+
+仓库根目录 **[license.env](../license.env)** 已写好：
+
+| 变量 | 值 |
+|------|-----|
+| `LICENSE_API_URL` | `https://sq.bz121.com` |
+| `LICENSE_CHECK_INTERVAL_DAYS` | `3` |
+| `LICENSE_OFFLINE_GRACE_DAYS` | `7` |
+| `LICENSE_WECHAT_ID` | `dekun03` |
+
+四个 `crypto_monitor_*` 启动时会通过 `license_lib.load_shared_env()` **自动加载**，无需在每个子目录重复配置。
+
+## 你必须做的一步（云端密钥对齐）
+
+在授权服务器上查看：
+
+```bash
+grep '^CLIENT_API_KEY=' /opt/crypto_monitor_web/.env
+```
+
+把输出值改成与 **`license.env`** 中一致：
+
+```env
+LICENSE_CLIENT_KEY=cm_user_sq_bz121_8f3a2c1d9e4b7a6f5d0e1b2c3a4f5e6
+```
+
+**方式 A（推荐）**：改服务器，与用户端 `license.env` 一致：
+
+```bash
+sudo nano /opt/crypto_monitor_web/.env
+# CLIENT_API_KEY=cm_user_sq_bz121_8f3a2c1d9e4b7a6f5d0e1b2c3a4f5e6
+sudo systemctl restart crypto-monitor-web
+```
+
+**方式 B**：若服务器已用安装脚本生成过随机密钥，则把该密钥复制到用户端 `license.env` 的 `LICENSE_CLIENT_KEY=` 一行。
+
+## 本地覆盖（可选）
+
+仓库根 `.env`（不提交 Git）可写：
+
+```env
+LICENSE_CLIENT_KEY=你的密钥
+```
+
+会覆盖 `license.env` 中的同名项。
+
+## 验证
+
+1. 启动任意子项目，浏览器打开 `http://127.0.0.1:端口/license`
+2. 应能看到设备 ID，且不再提示「未配置 LICENSE_API_URL」
+3. 在 https://sq.bz121.com/admin/ 生成激活码并兑换
+
+## 关闭许可（仅开发）
+
+在 `license.env` 或根 `.env` 中设置：
+
+```env
+LICENSE_DISABLED=true
+```