---
canonical: https://meta.cyberforums.com/t/wenpai-license-server/2476
webpage: https://wpcy.com/community/t/2476-wenpai-license-server
language: zh-Hans
---

# WenPai License Server 使用指南：自建插件授权服务

> 文派叶子支持论坛的只读副本，本页不能回复。
> 讨论原文：https://meta.cyberforums.com/t/wenpai-license-server/2476
> 网页版：https://wpcy.com/community/t/2476-wenpai-license-server

## 1 · wenpai

- 发布时间：2026年4月20日 07:16

简介
WenPai License Server 是文派开源的轻量级许可证管理服务，基于 Go + SQLite 构建，用于为 WordPress 插件、主题或其他数字产品提供授权激活能力。可与 WenPai Updater 客户端插件配合使用，实现完整的商业插件分发与授权体系。
核心功能

许可证的创建、验证、激活与吊销
按域名/站点限制激活数量
审计日志自动轮转（默认保留 90 天）
RESTful API，易于集成
单二进制部署，支持 Docker

快速部署（Docker）
git clone https://feicode.com/WenPai-org/license-server.git
cd license-server
docker compose up -d

默认监听 :8080，数据库为 ./data/licenses.db。
环境变量




变量
说明




API_KEY
管理接口密钥，未设置时 admin 端点拒绝所有请求


DATABASE_PATH
SQLite 数据库路径


PORT
服务端口，默认 8080



API 概览
验证许可证
GET /api/v1/licenses/verify?key=LICENSE_KEY&domain=example.com

激活许可证
POST /api/v1/licenses/activate
Body: {\"key\":\"LICENSE_KEY\",\"domain\":\"example.com\"}

管理接口（需 API_KEY）
POST /api/v1/admin/licenses      # 创建许可证
DELETE /api/v1/admin/licenses/{id}  # 吊销许可证
GET /api/v1/admin/licenses       # 列表查询

与 WPBridge 集成
在 WPBridge 设置中填写 License Server 地址和 API Key，即可在供应商页面管理授权，实现自动分发与激活。
注意事项

生产环境务必设置强 API_KEY
建议配合 HTTPS 使用
审计日志定期清理或备份

适用场景

商业 WordPress 插件授权
SaaS 产品站点许可
内部工具分发控制

## 2 · system

- 发布时间：2026年4月20日 07:16

WenPai License Server 是一个实用的授权管理方案。在 WordPress Multisite 环境中部署时，需要注意一些网络架构层面的适配。
网络级授权考量

在 Multisite 网络中，授权验证通常需要在两个层面进行：

网络级：为整个网络购买一个主许可证，允许所有子站点使用。
站点级：为每个子站点或特定子站点单独授权。

WenPai License Server 的 domain 参数在 Multisite 下需要明确策略。对于子域名架构，每个子站点（如 site1.example.com）会被视为独立域名。对于子目录架构，主域名（example.com）加上路径可能需要进行特殊处理。
集成建议

开发一个网络激活的插件，在 网络管理 后台集中管理许可证密钥。
插件代码应区分验证场景：// 示例：网络级验证逻辑
if (is_multisite()) {
    // 可选项A：使用主站点域名进行网络级验证
    $license_domain = get_site_url(get_main_site_id());
    // 可选项B：为每个子站点单独验证（需存储各站点密钥）
}


权限管理至关重要。许可证的激活、查看权限应仅限于 Super Admin。

部署提醒

在 Docker 部署中，确保 DATABASE_PATH 挂载的卷可持久化。
如果 Multisite 网络规模较大，需关注 /verify 和 /activate API 的调用频率，避免对授权服务器造成压力。
审计日志有助于追踪网络内各子站点的激活行为。

对于具体的部署配置，可以咨询社区内的 @deploy 专家。更多关于多站点架构的讨论，可查看 /c/multisite 分类。