> ## Documentation Index
> Fetch the complete documentation index at: https://www.kitemc.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 许可证激活

<span id="许可证激活" />

ArcPass 是付费插件，需要有效的许可证才能使用全部功能。

<h2 id="购买许可证">
  购买许可证
</h2>

<h3 id="可用版本">
  可用版本
</h3>

| 版本 | 价格 | 设备数量 | 单机端口数 | 开发者 API | 适用场景 |
| - | - | - | - | :-: | - |
| 标准版 | ¥68 | 5 台 | 3 端口 | ❌ | 个人/小型服务器 |
| 专业版 | ¥198 | 25 台 | 15 端口 | ✅ | 商业服务器、API 集成 |

<Tip>
  **说明**

  * **设备数量**：可绑定的「机器码 + IP + 端口」组合数量
  * **单机端口数**：同一台机器（相同机器码和 IP）上可运行的不同端口数量
  * 所有版本均为**永久买断**，一次购买，终身使用
  * **开发者 API** 仅专业版可用。标准版用户可随时升级。
</Tip>

<h3 id="购买渠道">
  购买渠道
</h3>

<Columns cols={2}>
  <Card title="立即购买" icon="shopping-cart" href="https://license.kitemc.com/products/arcpass" />

  <Card title="注册账户" icon="user-plus" href="https://license.kitemc.com/register" />
</Columns>

购买成功后，您可以在 [许可证管理页面](https://license.kitemc.com/dashboard/licenses) 查看您的密钥。

<h2 id="激活步骤">
  激活步骤
</h2>

<h3 id="_1-编辑配置文件">
  1. 编辑配置文件
</h3>

打开 `plugins/ArcPass/license.yml`：

```yaml theme={null}
# ========================================
#       ArcPass 许可证配置
# ========================================

# 配置版本（请勿修改）
config-version: 1

# 您的许可证密钥（从 KiteMC 获取）
# 格式: XXXX-XXXX-XXXX-XXXX
license-key: ""

# 说明: 许可证验证使用本地缓存（24小时有效）
# 网络问题时有 7 天宽限期
# 缓存文件: plugins/ArcPass/license.cache
```

<h3 id="_2-填写密钥">
  2. 填写密钥
</h3>

将空字符串替换为您收到的许可证密钥：

```yaml theme={null}
license-key: "XXXX-XXXX-XXXX-XXXX"
```

<h3 id="_3-重载配置">
  3. 重载配置
</h3>

执行命令或重启服务器：

```
/arcpass admin reload
```

<h3 id="_4-验证激活">
  4. 验证激活
</h3>

成功激活后，控制台会显示：

```
[ArcPass] License validated successfully!
[ArcPass] Licensed to: YourName
[ArcPass] Plan: Unlimited (50 devices)
[ArcPass] ArcPass v1.9.2 enabled!
```

<h2 id="许可证绑定">
  许可证绑定
</h2>

<h3 id="绑定机制">
  绑定机制
</h3>

ArcPass 使用以下信息进行服务器绑定：

* **机器码** - 服务器硬件唯一标识
* **IP 地址** - 服务器公网 IP
* **端口** - 服务器运行端口

首次激活时，许可证会自动绑定到当前服务器。

<h3 id="查看绑定状态">
  查看绑定状态
</h3>

```
/arcpass admin debug
```

<h3 id="解绑-换绑">
  解绑/换绑
</h3>

所有版本均支持**无限次换绑**，操作步骤如下：

1. 登录 [KiteMC 许可证中心](https://license.kitemc.com/dashboard/licenses)
2. 在「我的许可证」页面找到您的 ArcPass 许可证
3. 点击「查看详情」进入许可证详情页
4. 在右侧「绑定设备」区域进行管理：
   * 点击「重置绑定」可清除所有绑定
   * 点击设备旁的删除按钮可解绑单个设备
   * 点击端口旁的删除按钮可解绑单个端口

<Tip>
  **提示**

  解绑后，在新服务器上配置相同的许可证密钥并启动即可自动完成绑定。
</Tip>

<h2 id="许可证状态">
  许可证状态
</h2>

<h3 id="状态说明">
  状态说明
</h3>

| 状态 | 说明 |
| - | - |
| `VALID` | 许可证有效，插件正常运行 |
| `INVALID` | 密钥无效或格式错误 |
| `EXPIRED` | 许可证已过期（订阅制） |
| `SUSPENDED` | 许可证被暂停（违规使用） |
| `UNBOUND` | 未绑定服务器 |
| `LIMIT_EXCEEDED` | 超出绑定数量限制 |

<h3 id="离线模式">
  离线模式
</h3>

当无法连接许可证服务器时：

* 如果本地有缓存的验证结果，插件将继续运行
* 缓存有效期为 24 小时，并有 7 天宽限期
* 缓存文件位于 `plugins/ArcPass/license.cache`
* 超过宽限期后，插件功能将受限

<h2 id="常见问题">
  常见问题
</h2>

<h3 id="许可证验证失败">
  许可证验证失败
</h3>

1. 检查网络连接是否正常
2. 确认密钥输入正确（注意大小写）
3. 检查服务器防火墙设置

<h3 id="绑定数量已满">
  绑定数量已满
</h3>

1. 登录 [许可证中心](https://license.kitemc.com/dashboard/licenses) 查看当前绑定
2. 在许可证详情页解除不再使用的设备/端口绑定
3. 或升级到更高版本的许可证

<h3 id="更换服务器">
  更换服务器
</h3>

1. 登录 [许可证中心](https://license.kitemc.com/dashboard/licenses)
2. 进入许可证详情页，点击「重置绑定」或删除对应设备
3. 在新服务器配置相同的许可证密钥
4. 启动新服务器自动完成绑定

<h2 id="技术支持">
  技术支持
</h2>

遇到许可证问题？

<Columns cols={2}>
  <Card title="QQ 社区" icon="messages-square" href="https://qm.qq.com/q/R83fq82HWm">
    加入社区获取实时帮助
  </Card>

  <Card title="邮件支持" icon="mail" href="mailto:starry_cbz@outlook.com">
    [starry\_cbz@outlook.com](mailto:starry_cbz@outlook.com)
  </Card>

  <Card title="许可证中心" icon="ticket" href="https://license.kitemc.com/dashboard/licenses">
    管理许可证和绑定
  </Card>

  <Card title="登录账户" icon="key" href="https://license.kitemc.com/login">
    登录管理您的许可证
  </Card>
</Columns>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.