AstrBot / NapCat 统一管理
在同一控制台查看服务状态、访问地址、连接信息与最近操作，不再分散到多个终端窗口。
开源部署与 Web 管理
把 AstrBot 与 NapCat，
放进一个更好用的控制台。
淋雨为 Debian / Ubuntu 服务器提供一键部署与中文 Web 管理。多实例、日志、插件、备份恢复集中在一个入口，日常操作不必反复切回命令行。
- Docker Compose
- NapCat 多实例
- 深浅色界面
AstrBot服务控制
NapCat多实例
数据备份恢复
管理入口操作集中呈现
AstrBot启停、状态与日志
管理NapCat独立实例与扫码登录
查看备份创建、下载与恢复
打开部署任务过程可查看
- 检查 Docker
- 创建网络
- 分配实例端口
- 保存部署信息
统一入口少切换，更清楚
响应式电脑与手机都能用
一条命令启动面板优先的安装流程
一个入口集中管理 AstrBot 与 NapCat
多端访问桌面、平板和手机响应式布局
可回溯任务日志与面板审计日志
核心功能
日常要用的能力，放在顺手的位置。
不把命令行完全藏起来，而是把频繁、容易出错的操作整理成清晰的界面。每项能力均来自当前项目实现。
NapCat 多实例
每个实例拥有独立容器，以及各自的 NapCat 配置、QQ 数据、日志与插件目录，并自动分配可用端口。
启动、停止与重启
对 AstrBot 和单个 NapCat 实例执行常用服务操作，也可批量重启机器人实例。
日志与任务进度
查看容器、部署脚本和审计日志；异步任务展示进度、输出与失败信息。
插件与文件中心
上传插件 ZIP 包、查看已安装插件，并进行配置预览、JSON 校验、下载与应用。
备份与恢复
创建、列出、下载和恢复备份。恢复等高风险动作要求再次确认。
健康检查与自动恢复
集中检测 NapCat 实例；连续异常达到阈值后按限次策略尝试恢复，避免无限重启。
HTTPS 配置入口
已有域名时，可通过 Nginx、Certbot 与 Let’s Encrypt 配置 HTTPS 反向代理。
操作更直观
常用动作、状态和输出围绕任务组织，减少记命令、找容器和翻目录的次数。
多个实例统一管理
新增、删除、启停、扫码登录与连接配置都有固定入口，关键运行目录按实例分开管理。
手机也能完成日常管理
导航、卡片、表格和弹窗按设备重排，不是把桌面页面简单缩小。
部署与维护路径一致
安装、更新、备份、恢复和诊断脚本放在同一仓库，便于理解、迁移与继续扩展。
使用流程
从一台服务器，到可用的管理入口。
默认采用“面板优先”流程：先启动控制台，再在网页中完成 AstrBot 与 NapCat 的部署。
-
01
准备服务器
使用 Debian 或 Ubuntu，确保拥有 root 权限和可用网络。
-
02
运行安装命令
脚本检查环境并安装所需依赖，随后启动 Web 控制台。
-
03
登录面板
使用部署信息文件中的面板账号和随机初始密码登录，并及时修改面板密码。
-
04
添加实例并管理
填写 NapCat 数量与连接 Token，开始部署并在任务日志中查看进度。
快速安装
Debian / Ubuntu
$
bash <(curl -fsSL https://raw.githubusercontent.com/Ceiity/linyu/main/install.sh)
面板端口从 7070 起选择可用端口，具体地址会写入部署信息。
公网访问建议正式使用时绑定域名，并通过 Nginx 配置 HTTPS。
响应式适配
不是缩小页面，而是重新安排每一层信息。
桌面保留完整工作区，平板调整栏目密度，手机使用单列卡片与触控导航。深浅色模式默认跟随系统。
- Windows
- macOS
- Android
- iPhone
- iPad
触控友好
移动端主要点击区域不低于 44px，表格转为卡片，危险操作仍保留确认步骤。
iOS Safari 适配
使用 viewport-fit、动态视口单位和安全区域内边距，处理地址栏与底部手势区域。
横竖屏重排
手机、平板和常见笔记本会按视口与内容重排，低高度横屏也会收紧间距。
安全设计
把关键边界说清楚，也把危险操作放慢一点。
控制台提供登录保护、会话失效、敏感信息脱敏与审计记录。公网部署仍应使用 HTTPS，并限制不必要的端口暴露。
权限边界当前是单管理员面板，通过登录会话、动作白名单与远程主人名单限制操作；不宣称多角色权限体系。
登录失败限制
面板在 10 分钟窗口内累计登录失败；达到 5 次后临时限制 30 分钟，并统一失败提示。
会话管理
会话保存在签名 HttpOnly、SameSite=Strict Cookie 中；HTTPS 下追加 Secure 标记。
密码修改后失效旧会话
保存新密码时更新会话密钥，已登录设备需要重新验证。
危险操作二次确认
删除实例、删除文件和恢复备份等操作要求确认，部分能力还需在设置中先开启。
脱敏与审计
设置、会话与任务日志等通用响应按规则隐藏敏感字段，操作写入面板审计日志。
使用现代浏览器的 Windows、macOS、Android、iPhone 与 iPad 均可访问。服务端运行在 Debian 或 Ubuntu。
支持。手机端采用单列卡片、底部导航和触控尺寸按钮，表格内容会按移动端重新组织。
支持。官网与控制台均考虑安全区域、动态视口和 16px 输入字号，避免常见的遮挡与自动缩放问题。
局域网或临时测试可以直接使用服务器 IP。申请 Let’s Encrypt 证书时需要已解析到服务器的域名。
本地测试不是硬性要求；只要通过公网访问，就建议使用 HTTPS，避免登录凭据和会话在传输中暴露。
支持多个 NapCat 实例。每个实例使用独立容器，以及各自的 NapCat 配置、QQ 数据、日志与插件目录，并自动选择可用端口。
控制台支持上传并安装 AstrBot 插件 ZIP 包，也能调整插件目录。插件本身的兼容性以 AstrBot 版本和插件说明为准。
可通过 GitHub Issue 联系。若官网同时显示邮件或项目社群入口，也可以使用对应渠道。
项目没有声明固定的最低规格。实际 CPU、内存和磁盘需求取决于实例数量与负载，建议从少量实例开始并观察资源占用。
联系与支持
问题说具体，沟通会更快。
提交问题时，请附上系统版本、执行步骤和脱敏后的日志。不要公开粘贴密码、Token 或完整部署信息。