RustPanel

RustPanel 是一款对标宝塔免费功能、但底层全面现代化的新一代 Rust 服务面板。它摒弃了传统面板混杂的 API 结构与重度依赖宿主机环境的设计，采用强类型契约、极简部署机制与“容器优先”的现代应用架构。

核心特性

• 现代通信底座：采用 Protobuf + gRPC 和 Axum 混合路由，实现高性能、强约束的通信协议。
• 极简部署：利用 rust-embed 将前端打包内联进单一二进制文件，只需一个文件即可运行整个控制面板。
• 实时监控与极速终端：内嵌基于 xterm.js + portable-pty 的 Web SSH，并实时推流展示系统状态指标。
• 现代化文件管理：非阻塞的深层文件遍历、大文件流式传输，以及集成 Monaco Editor 的在线源码编辑。
• Docker-First 应用商店：抛弃易污染宿主机的源码编译模式，直接对接 Docker API，全面容器化管理（支持 MySQL, Redis 等一键拉起与 Compose 编排）。跑不了 Docker 的低配机（OpenVZ / ~128MB）走静态站 + 反代 + 原生进程的非容器主线，能力探针会自动置灰不可用模块。
• 极简 Web Server 与自动 SSL：化繁为简的 Nginx 反代配置，结合 acme-lib 自动化 Let's Encrypt 证书签发与后台静默续期。
• 运维闭环：通知告警中心（Webhook / Telegram / 钉钉 / 企业微信 / Bark）、备份与还原（本地 / WebDAV / S3 兼容 / restic 增量）、数据库可视化、多用户 RBAC、访问统计、DNS 托管、Linux 工具箱。
• 面向低配主机的安全默认值：登录失败按账号指数退避锁定，机密状态文件一律 0600 落盘，改角色 / 改密码 / 删用户即刻吊销旧令牌。

架构演进路线图

关于 RustPanel 的路线图与各个阶段的详细任务：

• v2.0 架构演进路线（已完成）
• v3.0 宝塔免费版功能对齐（已完成）
• v4.0 宝塔功能补齐（编码任务已全部收口；FTP 与原生多版本运行时经评估决定不做，理由见文档内结论段）

v4.0 的验证计划中 V-02 / V-03 / V-04（通知、备份还原、数据库 GUI 的端到端验证）需要真机 + MinIO / restic / 真实数据库实例，属于部署后人工验证项，尚未执行。

快速开始

一键安装

Linux 服务器可使用类似宝塔的下载安装脚本方式部署：

url=https://raw.githubusercontent.com/IShinji/RustPanel/main/deploy/install.sh;if command -v curl >/dev/null 2>&1;then curl -fsSL "$url" -o rustpanel-install.sh;else wget -O rustpanel-install.sh "$url";fi;sudo bash rustpanel-install.sh

默认安装到 /www/wwwroot/rustpanel。脚本默认进入交互式安装，会依次询问：

• NAT 放通端口段（例：1200-1219，无 NAT 限制直接回车跳过）
• 面板访问端口（浏览器实际访问的端口，必须落在 NAT 段内）
• 公网 IP 或域名（NAT 机自动探测会拿到内网 IP，需手动覆盖）
• 绑定地址、Profile、HTTPS Origin、管理员凭据
• 是否启用极限低内存模板（micro 档可再禁 proxy/workloads）

完成后管理员密码、JWT 密钥、最终面板 URL 都会打印并写入 /www/wwwroot/rustpanel/.env。

非交互场景（CI、自动化）传 --assume-recommended 跳过所有提问：

sudo bash rustpanel-install.sh --assume-recommended --port 18888 --origin https://panel.example.com
sudo bash rustpanel-install.sh --assume-recommended --bind 127.0.0.1 --port 18080
sudo bash rustpanel-install.sh --assume-recommended --profile micro \
  --nat-port-range 1200-1219 --port 1200 --public-host 1.2.3.4

Micro 极限模式

micro 档位面向 128MB RAM、2GB 磁盘、NAT IPv4、OpenVZ 这类极限小鸡。安装器会先做磁盘/内存硬门禁（<500MB / <80MB 直接 fail），再探测虚拟化和 Docker 能力，在低配或 OpenVZ 环境下推荐二进制裸跑模式，默认启用内置静态托管、轻量任务托管和用户态代理，禁用 Docker、应用商店、Nginx 站点和 SSL 自动化。128MB 实在紧时可在交互流程末尾启用、或直接加 --ultra-low 再禁掉 proxy 和 workloads。

micro 档还默认启用节俭模式:

• 下载精简构建 rustpanel-backend-micro-linux-amd64.tar.gz(cargo build --release --no-default-features,不含 Docker API / MySQL / Postgres / Redis / portable-pty,终端用内置 openpty,数据库仅 SQLite);
• tokio 最多 2 个工作线程(TOKIO_WORKER_THREADS 可覆盖),systemd 单元带 MALLOC_ARENA_MAX=2;
• 端口交给 rustpanel-backend.socket,面板空闲 RUSTPANEL_IDLE_EXIT_MINUTES(默认 10)分钟后退出,下一个请求由 systemd 按需拉起;有 WS 终端、上传部署、托管进程或回滚计时器时不会退出;
• 计划任务写进 /etc/cron.d/rustpanel 由系统 cron 调 --run-cron-task,证书续签由 rustpanel-cert-renew.timer 每天调一次 --renew-certs。

不想要节俭模式可加 --no-frugal;其它档位也可用 --frugal 强制开启。

面板访问安全

• 两步验证:设置 → 安全 →「两步验证」里扫码绑定,输入验证码确认后生效;关闭同样需要验证码。
• 只允许经 Cloudflare 访问:面板挂在 Cloudflare 代理的域名后面时,可在 .env 设 RUSTPANEL_PANEL_TRUSTED_SOURCES=cloudflare(安装时加 --cloudflare-only),直连 IP:端口 一律 403;本机回环始终放行,额外放行的网段写在 RUSTPANEL_PANEL_ALLOW_CIDRS(逗号分隔)。 开启前先确认能通过域名打开面板,否则只能 SSH 上去改 .env 恢复。
• 自动证书:在 DNS 页填 Cloudflare API Token(Zone → DNS → Edit)与 Zone ID 后, 该 Zone 下域名的 Let's Encrypt 证书走 DNS-01 全自动签发与每日续签(NAT 机器也可用)。

安装前可先查看建议：

sudo bash rustpanel-install.sh --dry-run

请参阅完整使用指南：入门指南 (Getting Started)、NAT VPS 部署

开发与协作规范

本项目采用 Agent 协作驱动（Vibe Coding）的理念推进。为保证最高优先级的质量门槛，所有 Agent 或开发者参与时必须遵循以下规范：

• AGENTS.md：项目的最高优先级执行规则（架构约束、验证、提交规范等）。
• CLAUDE.md：角色目录和执行流程约束。
• GEMINI.md：快捷上下文与常用指令。