引言

因为官方文档里的Linux部署教程已经足够详尽，本篇会重点介绍Windows系统和软路由系统的部署

Nekro Agent 文档：https://doc.nekro.ai/

Linux部署

一键部署 Nekro Agent 核心服务及 Napcat 协议端

警告：

务必修改NapCat默认密码：公网WebU 必须使用强密码（建议12位以上，含数字、字母、符号）
务必使用Token验证：OneBot服务务必设置有效 Token，避免空Token或弱口令
为安全起见，请避免使用默认端口

部署命令

从 Github

1	sudo -E bash -c "$(curl -fsSL https://raw.githubusercontent.com/KroMiose/nekro-agent/main/docker/install.sh)" - --with-napcat

如果从 Github 下载脚本遇到网络问题，您可以使用 NekroEndpoint 代理访问部署脚本：

从 NekroEndpoint

TIP

NekroEndpoint 是基于 Cloudflare Workers 构建的边缘端点编排平台，支持静态内容返回、代理转发、动态脚本执行三类端点，提供权限组、访问密钥等细粒度权限控制，依托全球 300 + 节点实现毫秒级响应，可用于 API 代理聚合、Webhook 处理等场景。

1	sudo -E bash -c "$(curl -fsSL https://ep.nekro.ai/e/KroMiose/nekro-agent/main/docker/install.sh)" - --with-napcat

提示

上述命令中的 --with-napcat 参数会启动全自动标准部署
如果不加此参数，脚本会以交互模式启动，届时请选择 Y 以安装 Napcat
部署完成后，请参考协议端配置-Napcat文档完成后续配置

协议端配置

打开 Nekro Agent WebUI： http://<你的服务ip>:8021
使用安装脚本提供的账号密码登录
配置 NapCat：
- 默认情况下 NapCat WebUI 地址应当为 http://<你的服务ip>:6099/webui (可在「系统配置」→「基本配置」中修改)
- 在「协议端」→「NapCat」→「容器日志」获取 NapCat 登录 Token (新版本 NapCat 默认登陆 Token 为 napcat 请在登陆后及时修改！)
- 在「协议端」→「NapCat」→「WebUI」使用 Token 登录并登陆需要作为 Bot 的 QQ 帐号
- 在「网络配置」中添加 Websocket 客户端：
  - 添加 URL：ws://nekro_agent:8021/onebot/v11/ws (URL 走容器网络通信方式，不论是否修改了端口都使用此地址)
  - 配置 OneBot 访问密钥，即本页面上方显示的 OneBot 访问密钥
  - 打开「启用」开关并保存

配置完成后，请参考系统配置指南文档继续基本应用配置即可开始使用

Windows部署

介绍

我们需要利用WSL为Windows创造Linux环境安装Docker来部署Nekro Agent

WSL安装Linux

Microsoft文档：https://learn.microsoft.com/zh-cn/windows/wsl/install

开启”适用于linux的windows子系统”：
- 控制面板 –> 程序 –> 启动或关闭Windows功能 –> ~~
- 应用更改后重新启动
安装Ubuntu：
- 打开Windows PowerShell
- 输入：wsl --install 回车
- PowerShell会自动安装Ubuntu并启动
  - “Create a default Unix user account”：
    - 设置用户名
  - “New password”：
    - 设置密码：一个a也行
  - “Retype new password”
    - 再次输入密码
- 安装完成