exflower-license-server 1.3.2 → 1.4.0

package/README.md

@@ -2,6 +2,90 @@
 
 ExFlower 在线授权验证服务。管理 License Key、企业授权、实例追踪、模板分发。
 
+## 私有化自助部署手册（客户 IT 照此执行）
+
+前提：一台 Linux 服务器（1C1G 即可），已装 Docker；防火墙放行 4001（或反代用的 80/443）；能访问 `https://license.exflower.pro`（每日激活复核）。
+
+### 第 1 步：获取部署文件
+
+只需 `Dockerfile` 与 `docker-compose.yml` 两个文件（镜像构建时会自动从 npm 拉取服务本体，无需完整源码）：
+
+```bash
+npm pack exflower-license-server
+tar xzf exflower-license-server-*.tgz package/Dockerfile package/docker-compose.yml --strip-components=1
+```
+
+### 第 2 步：构建镜像
+
+```bash
+# 指定版本构建；国内服务器建议加 npm 镜像源参数
+docker build --build-arg VERSION=1.3.2 \
+  --build-arg NPM_REGISTRY=https://registry.npmmirror.com \
+  -t exflower/license-server:1.3.2 .
+```
+
+### 第 3 步：生成管理员 Token（请自行保管，厂商不需要知道）
+
+```bash
+# 生成随机 Token —— 这就是管理后台的登录凭证，只显示这一次，立即妥善保存
+TOKEN=$(openssl rand -hex 24) && echo "Admin Token: $TOKEN"
+
+# 计算哈希（部署配置里只放哈希，不落明文）
+echo -n "$TOKEN" | sha256sum | cut -d' ' -f1    # macOS 用: shasum -a 256
+```
+
+### 第 4 步：启动服务
+
+```bash
+docker run -d --name exflower-license-server --restart unless-stopped \
+  -p 4001:4001 \
+  -v license-data:/app/data \
+  -e NODE_ENV=production \
+  -e PORT=4001 \
+  -e LICENSE_DATA_DIR=/app/data \
+  -e ADMIN_TOKEN_HASH=<第3步算出的哈希> \
+  exflower/license-server:1.3.2
+```
+
+### 第 5 步：验证 + 激活（必做）
+
+```bash
+# 健康检查
+curl http://127.0.0.1:4001/health
+```
+
+1. 浏览器打开 `http://<服务器IP>:4001/admin`，用第 3 步的 Token 登录
+2. 进入「中央激活」，输入**厂商签发的 customer_key**（格式 `EXFC-XXXXXX-…`，向厂商索取）并激活
+3. ⚠️ **未激活前所有客户端接口一律 403**，激活后立即恢复；之后每日自动复核，中央短暂不可达不影响服务
+
+### 第 6 步：发放激活码
+
+管理台「License 管理」→ 新建 License（备注用途、选有效期与实例数）→ 完整 Key **仅显示一次**，复制交付给终端用户在客户端填写。客户端「授权服务器地址」填 `http://<服务器IP>:4001`（配置了域名反代则填域名）。
+
+### 升级版本
+
+```bash
+docker build --build-arg VERSION=<新版本> -t exflower/license-server:<新版本> .
+docker rm -f exflower-license-server
+# 用与第 4 步完全相同的参数重新 docker run（数据在命名卷 license-data 里，不受影响）
+```
+
+⚠️ 不要使用 `docker compose down -v`——`-v` 会连数据卷一起删除。
+
+### （可选）HTTPS 反代
+
+以 Caddy 为例（`Caddyfile` 一行搞定，自动签发证书）：
+
+```
+license.example.com {
+    reverse_proxy 127.0.0.1:4001
+}
+```
+
+⚠️ 境内服务器挂域名须已完成 ICP 备案，否则 80/443 会被云厂商拦截。
+
+---
+
 ## 快速开始
 
 ### 方式一：npm 全局安装（推荐）
@@ -12,7 +96,7 @@ npm install -g exflower-license-server
 
 # 查看版本
 exflower-license-server --version
-# 输出: 1.3.1
+# 输出: 1.3.2
 
 # 运行
 exflower-license-server
@@ -31,10 +115,10 @@ docker build -t exflower/license-server:latest .
 
 # 国内构建机走镜像源（npm registry 与 alpine apk 源都可换）
 docker build \
-  --build-arg VERSION=1.3.1 \
+  --build-arg VERSION=1.3.2 \
   --build-arg NPM_REGISTRY=https://registry.npmmirror.com \
   --build-arg APK_MIRROR=mirrors.cloud.tencent.com \
-  -t exflower/license-server:1.3.1 .
+  -t exflower/license-server:1.3.2 .
 
 # 使用 docker-compose（推荐）
 docker-compose up -d
@@ -238,8 +322,10 @@ sudo systemctl enable --now exflower-license-server
 | `/api/admin/templates` | GET/POST | 模板列表/创建 |
 | `/api/admin/templates/:id` | PATCH/DELETE | 更新/删除模板 |
 | `/api/admin/templates/library` | POST | 资料图谱模板上传（multipart，字段 `file`，`.exflib`） |
-| `/api/admin/template-categories` | GET/POST | 模板分类列表/创建（按类型分组） |
+| `/api/admin/templates/doc-upload` | POST | 知识库文档包上传（v1.3.2 起；multipart，字段 `file`，zip 内含 `README.md` + `assets/`） |
+| `/api/admin/template-categories` | GET/POST | 模板分类列表/创建（按类型分组，按 `sort_order` 排序返回） |
 | `/api/admin/template-categories/:id` | PATCH/DELETE | 分类改名/删除 |
+| `/api/admin/template-categories/order` | PUT | 分类手动排序（v1.3.2 起；body `{type, ids:[...]}`，客户端按此顺序展示分类） |
 | `/api/admin/imports` | GET | 导入统计（支持 `?template_id=` / `?company_id=` 过滤） |
 | `/api/admin/packages` | GET/POST | 轻应用包列表/上传（multipart，字段 `file`+`company_id`） |
 | `/api/admin/packages/:id` | DELETE | 删除轻应用包 |
@@ -259,6 +345,7 @@ sudo systemctl enable --now exflower-license-server
 管理后台根据类型提供不同的上传方式：
 
 - **agent / excard / doc**：**Markdown 原生上传**。直接上传客户端导出的 `.md` 文件（或粘贴 Markdown 文本），后台自动解析 frontmatter 预填模板名称并生成 `content_json`，无需手写 JSON。
+- **doc 附加方式（v1.3.2 起）**：可改传一个 **zip 文档包**（根目录 `README.md` + `assets/` 附件目录），与客户端「发布到模板库」的产物格式一致；名称留空自动取 README 的一级标题。选了 zip 则以包内容为准。
 - **library**：上传客户端导出的 `.exflib` 包（multipart `POST /api/admin/templates/library`，字段 `file`），服务端解包校验 manifest（`format: exflower-library`）并记录文件大小与 sha256；客户端经 `GET /api/templates/:id/download` 下载导入。
 - **workflow**（暂不开放）：以 JSON 描述步骤结构，上传框预填骨架示例。
 

package/db.js

@@ -239,6 +239,9 @@ db.exec(`
   CREATE INDEX IF NOT EXISTS idx_client_versions_platform ON client_versions(platform, is_latest)
 `);
 
+// 幂等列迁移：CDN 远程地址（有值 = 文件在中央 CDN，本地不落盘；PLAN-CDN-DISTRIBUTION）
+try { db.exec('ALTER TABLE client_versions ADD COLUMN remote_url TEXT'); } catch { /* 已存在 */ };
+
 // ── Server-level settings（品牌等全局配置，私有化部署 = 一个组织） ──
 db.exec(`
   CREATE TABLE IF NOT EXISTS settings (

package/index.js

@@ -54,6 +54,9 @@ setupRoutes(app);
 // ── 中央激活调度：已配置 customer_key 则启动即复核，之后每日复核（失败 1 小时重试） ──
 require('./activation').startScheduler();
 
+// ── 客户端版本 manifest 同步（启动即拉一次 + 每小时兜底；失败维持本地） ──
+require('./updateSync').startUpdateSync();
+
 app.listen(PORT, () => {
   const tokenLine = ADMIN_TOKEN_HASH
     ? 'Admin Token: (hashed via ADMIN_TOKEN_HASH)'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "exflower-license-server",
-  "version": "1.3.2",
+  "version": "1.4.0",
   "description": "ExFlower License Server - 在线授权验证服务",
   "main": "index.js",
   "bin": {

package/routes.js

@@ -10,6 +10,7 @@ const unzipper = require('unzipper');
 const { queryAll, queryGet, queryRun, getSetting, setSetting, DATA_DIR } = require('./db');
 const { generateLicenseKey, generateId } = require('./utils');
 const activation = require('./activation');
+const { ensureFresh } = require('./updateSync');
 
 const DEFAULT_ADMIN_TOKEN = 'exflower-admin-2026';
 // ADMIN_TOKEN_HASH（sha256 hex）优先；否则用明文 ADMIN_TOKEN。二选一。
@@ -154,13 +155,21 @@ function buildLatestYml(mac) {
   // version 取各行里语义最新（简单按创建时间最新的一行）
   rows.sort((a, b) => (a.created_at < b.created_at ? 1 : -1));
   const esc = (s) => String(s).replace(/'/g, "''");
+  // 本地文件就绪（存在且大小匹配）→ 本地相对路径（客户端局域网速度）；
+  // 否则 remote_url（CDN）兜底——后台下载完成后下一轮自动切回本地
+  const fileUrl = (r) => {
+    if (r.file_path && fs.existsSync(r.file_path) && fs.statSync(r.file_path).size === r.file_size) {
+      return `files/${r.platform}/${esc(r.file_name)}`;
+    }
+    return r.remote_url || `files/${r.platform}/${esc(r.file_name)}`;
+  };
   const lines = [`version: ${rows[0].version}`, 'files:'];
   for (const r of rows) {
-    lines.push(`  - url: 'files/${r.platform}/${esc(r.file_name)}'`);
+    lines.push(`  - url: '${fileUrl(r)}'`);
     lines.push(`    sha512: '${r.sha512}'`);
     lines.push(`    size: ${r.file_size}`);
   }
-  lines.push(`path: 'files/${rows[0].platform}/${esc(rows[0].file_name)}'`);
+  lines.push(`path: '${fileUrl(rows[0])}'`);
   lines.push(`sha512: '${rows[0].sha512}'`);
   lines.push(`releaseDate: '${new Date(rows[0].created_at.replace(' ', 'T') + 'Z').toISOString()}'`);
   return lines.join('\n') + '\n';
@@ -1307,16 +1316,18 @@ function setupRoutes(app) {
   });
 
   // ── Client Updates: client-facing (electron-updater generic provider) ──
-  app.get('/api/updates/latest.yml', (req, res) => {
+  app.get('/api/updates/latest.yml', async (req, res) => {
     if (!companyByLicenseKey(req, res)) return;
+    await ensureFresh(); // manifest 过期则先同步中央（失败不阻塞）
     const yml = buildLatestYml(false);
     if (!yml) return res.status(404).json({ success: false, message: 'No win update available' });
     res.setHeader('Content-Type', 'text/yaml; charset=utf-8');
     res.send(yml);
   });
 
-  app.get('/api/updates/latest-mac.yml', (req, res) => {
+  app.get('/api/updates/latest-mac.yml', async (req, res) => {
     if (!companyByLicenseKey(req, res)) return;
+    await ensureFresh();
     const yml = buildLatestYml(true);
     if (!yml) return res.status(404).json({ success: false, message: 'No mac update available' });
     res.setHeader('Content-Type', 'text/yaml; charset=utf-8');
@@ -1330,7 +1341,10 @@ function setupRoutes(app) {
       'SELECT * FROM client_versions WHERE platform = ? AND file_name = ?',
       [platform, filename]
     );
-    if (!row || !fs.existsSync(row.file_path)) {
+    if (!row) return res.status(404).json({ success: false, message: 'Update file not found' });
+    if (!fs.existsSync(row.file_path)) {
+      // 本地无文件但有 CDN 地址 → 302 兜底（对齐 ensureFresh 未覆盖的旧 yml 场景）
+      if (row.remote_url) return res.redirect(302, row.remote_url);
       return res.status(404).json({ success: false, message: 'Update file not found' });
     }
     res.setHeader('Content-Type', 'application/octet-stream');
@@ -1341,7 +1355,7 @@ function setupRoutes(app) {
   // ── Client Updates: admin ──
   app.get('/api/admin/updates', requireAdmin, (req, res) => {
     const updates = queryAll(
-      'SELECT id, platform, version, file_name, file_size, sha512, release_notes, is_latest, created_at FROM client_versions ORDER BY created_at DESC'
+      'SELECT id, platform, version, file_name, file_size, sha512, release_notes, is_latest, remote_url, created_at FROM client_versions ORDER BY created_at DESC'
     );
     res.json({ success: true, updates });
   });