iSrvd

September 7, 2026 · View on GitHub

名称源自 "it is a server daemon"，srv 对应 Linux 惯例目录 /srv，d 代表 daemon。发音：读作 "I served"（/ˈaɪ sɜːrvd/），谐音"爱服务"。

基于 Go + Vue 3 构建的轻量级运维面板，集成文件管理、Docker 容器编排、APISIX/Caddy 网关配置、Web 终端、GPU 监控、计划任务与 AI 助手，为个人服务器与中小型团队提供一站式管理体验。

功能特性

模块	功能
系统概览	CPU、内存、磁盘、网络、Go 运行时与 GPU 监控，支持历史数据采集、服务可用性探测和在线升级
文件管理	浏览、上传、下载、编辑、创建/删除目录、重命名、权限修改、压缩/解压
Web 终端	基于 xterm.js 的 Shell 终端，支持容器终端接入
SSH 远程管理	管理主机与可复用凭据，支持密码/私钥认证、浏览器终端和 SFTP 文件管理
AI 助手	内置 Copilot，基于 CopilotKit + AG-UI 协议，通过内置 OpenAPI 目录调用后端接口，支持页面上下文、工具卡片与写操作审批，兼容 OpenAI API 的 LLM 接入
计划任务	定时任务调度，支持 Shell/BAT/PowerShell/可执行文件，以及 Docker 临时容器或已有容器执行模式
APISIX	路由、Consumer、上游(Upstream)、SSL 证书、插件配置(PluginConfig)、插件列表、访问授权管理
Caddy	HTTP 服务、路由、Basic Auth、SSL 证书、全局选项管理，支持原始配置编辑
Docker	容器、镜像、网络、卷、镜像仓库管理，容器文件、实时日志、资源统计、终端接入、镜像构建/推送/拉取
Swarm	集群信息、节点、服务、任务管理，服务日志、强制更新、加入令牌管理
Compose	文件编辑、Docker Compose / Swarm Stack 部署与重部署
成员管理	多用户、家目录隔离、路由级权限控制、API 令牌、TOTP 二次验证和 Passkey 无密码登录
系统管理	配置管理、操作审计日志、OIDC 认证集成、代理认证头登录
移动端	响应式布局，适配移动设备

技术栈

层级	技术
后端	Go 1.25+ / Gin / golang-jwt
前端	Vue 3 / TypeScript / Tailwind CSS / Pinia
终端	xterm.js
容器	Docker / APISIX / Caddy
AI	兼容 OpenAI API 的 LLM 接入，前端基于 CopilotKit + AG-UI 协议

Docker 部署

提供三个镜像版本：

镜像	说明
`rehiy/isrvd:slim`	默认版本，仅含 isrvd，适合大多数场景
`rehiy/isrvd:apisix`	isrvd + APISIX，集成 API 网关
`rehiy/isrvd:caddy`	isrvd + Caddy，集成反向代理与 TLS 管理

CNB 流水线会同步推送到 CNB Docker 制品库，镜像路径为 docker.cnb.cool/<repo-slug>:<tag>，支持 slim、caddy、apisix 三个标签，其中 slim 同时作为 latest。国内 Docker 部署可将下方示例中的 rehiy/isrvd:<tag> 替换为 docker.cnb.cool/rehiy/isrvd:<tag>。

Docker 版默认管理员账号为 admin / admin，首次登录成功后会自动跳转至修改密码页面。

脚本安装（推荐）

安装脚本会自动安装 Docker、初始化单节点 Swarm、创建可挂载的 overlay 网络 sdnet，并根据参数启动对应的一体化镜像：

该脚本面向使用 systemd 的 Linux，需以 root 用户执行。

# slim / caddy / apisix 三选一
bash <(curl -sL https://jscdn.rehi.org/gh/rehiy/isrvd/build/script/isrvd.sh) install --docker
bash <(curl -sL https://jscdn.rehi.org/gh/rehiy/isrvd/build/script/isrvd.sh) install --caddy
bash <(curl -sL https://jscdn.rehi.org/gh/rehiy/isrvd/build/script/isrvd.sh) install --apisix

Docker 版统一使用容器名 isrvd，数据保存在 /srv/data；update 会按当前镜像类型重建容器，uninstall 删除容器但保留数据目录。

创建网络

使用安装脚本时无需手动操作。手动部署 Docker 版时，推荐先初始化 Swarm，再创建可挂载的 overlay 网络：

docker swarm init
docker network create --driver=overlay --attachable sdnet

slim（默认）

仅含 isrvd 本体，体积最小，适合只需要文件管理、Docker/Swarm/Compose、计划任务等功能的场景。

docker run -d \
  --name isrvd \
  --network sdnet \
  -p 8080:8080 \
  -v /srv/data:/data \
  -v /var/run/docker.sock:/var/run/docker.sock \
  rehiy/isrvd:slim

端口映射	服务	说明
8080 → 8080	isrvd	Web 管理界面

apisix（集成 API 网关）

isrvd + APISIX，适合已使用 APISIX 作为 API 网关的场景。

docker run -d \
  --name isrvd \
  --network sdnet \
  -p 8080:8080 \
  -p 80:9080 \
  -p 443:9443 \
  -v /srv/data:/data \
  -v /var/run/docker.sock:/var/run/docker.sock \
  rehiy/isrvd:apisix

端口映射	服务	说明
8080 → 8080	isrvd	Web 管理界面
80 → 9080	APISIX	HTTP 代理端口
443 → 9443	APISIX	HTTPS 代理端口

caddy（集成反向代理）

isrvd + Caddy，适合需要反向代理、自动 HTTPS（ACME）或统一网关管理的场景。

docker run -d \
  --name isrvd \
  --network sdnet \
  -p 8080:8080 \
  -p 80:80 \
  -p 443:443 \
  -v /srv/data:/data \
  -v /var/run/docker.sock:/var/run/docker.sock \
  rehiy/isrvd:caddy

端口映射	服务	说明
8080 → 8080	isrvd	Web 管理界面
80 → 80	Caddy	HTTP 代理端口
443 → 443	Caddy	HTTPS 代理端口

Caddy 默认 HTTP 服务监听 :80 和 :443，但禁用了自动 HTTPS 及重定向。如需 HTTPS，可在「Caddy → 服务」中编辑对应服务的 HTTPS 行为，或直接编辑「原始配置」。

Docker Compose

services:
  isrvd:
    image: rehiy/isrvd:slim
    container_name: isrvd
    restart: unless-stopped
    networks:
      - sdnet
    ports:
      - "8080:8080"
    volumes:
      - /srv/data:/data
      - /var/run/docker.sock:/var/run/docker.sock

networks:
  sdnet:
    external: true

注意：

请先创建 sdnet 网络（见上方「创建网络」章节），Compose 中通过 external: true 引用已有网络

请始终挂载整个 /data 目录，避免容器重建时数据丢失

二进制部署

目录：/usr/local/isrvd/，包含二进制和配置文件
限制：无法通过容器内网访问其它容器
安装脚本适用于使用 systemd 的 Linux，需以 root 用户执行

# 一键安装（默认自动按 IP 选择 CNB/GitHub 源，可用 --cn / --global 手动指定）
bash <(curl -sL https://jscdn.rehi.org/gh/rehiy/isrvd/build/script/isrvd.sh) install
bash <(curl -sL https://jscdn.rehi.org/gh/rehiy/isrvd/build/script/isrvd.sh) install --cn

# 更新/卸载/仅下载
bash <(curl -sL https://jscdn.rehi.org/gh/rehiy/isrvd/build/script/isrvd.sh) update
bash <(curl -sL https://jscdn.rehi.org/gh/rehiy/isrvd/build/script/isrvd.sh) update --global
bash <(curl -sL https://jscdn.rehi.org/gh/rehiy/isrvd/build/script/isrvd.sh) uninstall
bash <(curl -sL https://jscdn.rehi.org/gh/rehiy/isrvd/build/script/isrvd.sh) download

也可直接运行 ./isrvd，通过 CONFIG_PATH 指定配置位置：

# 默认读取 ./config.yml
./isrvd

# 本地 YAML
CONFIG_PATH=/data/conf/isrvd.yml ./isrvd

# etcd（value 仍为 config.yml 同款 YAML）
etcdctl put /isrvd/config "$(cat /data/conf/isrvd.yml)"
CONFIG_PATH="etcd://user:pass@127.0.0.1:2379/isrvd/config?scheme=http&timeout=5s" ./isrvd

# etcd key 不存在时，用 fallback YAML 初始化并写入 etcd
CONFIG_PATH="etcd://127.0.0.1:2379/isrvd/config?fallback=/data/conf/isrvd.yml" ./isrvd

# etcd 完整配置示例
# etcd://user:pass@host1:2379,host2:2379/key?scheme=http&timeout=5s&fallback=/path/config.yml

etcd 认证可省略，也可用 ETCD_USERNAME / ETCD_PASSWORD 补充或覆盖 URI 中的认证信息。etcd key 发生 PUT 变更时，isrvd 会重载配置、注册中心和业务服务。通过系统配置 API 保存的本地 YAML 也会立即触发重载；若直接在磁盘上修改 YAML，则需发送 SIGHUP 或重启进程。

本地开发

环境要求

Go：用于后端服务与命令行构建
Node.js / npm：用于 webview 前端开发与构建（持续集成环境使用 Node.js 24）
Docker：可选，用于 Docker、Swarm、Compose 相关功能调试

启动开发环境

./develop.sh

开发脚本会自动：

后端：复制 config.yml 为 .local.yml（如不存在），并通过 CONFIG_PATH=.local.yml go run cmd/server/main.go 启动
前端：进入 webview，安装依赖并执行 npm run dev
端口清理：启动前尝试释放 8080 和 3000 端口

Windows 环境可使用：

develop.bat

Windows 脚本直接使用根目录的 config.yml 启动后端，并执行 npm run dev；需先在 webview 目录安装前端依赖。

构建与校验

# 完整分发构建
./build.sh

# 后端全包编译检查
go test ./...

# Go 静态检查
go vet ./...

# 前端类型检查
(cd webview && npm run lint)

# 前端格式与 import 排序检查
(cd webview && npm run format:check)

# 前端样式一致性检查
(cd webview && python3 scripts/review-style.py)

# 空白与冲突标记检查（在仓库根目录执行）
git diff --check

贡献代码前请优先阅读 AGENTS.md。该文件是当前仓库的代码规范与协作约定入口，旧版 CODE_STYLE 不再作为规范来源。

配置说明

配置段	说明
`schema`	配置结构版本，用于自动迁移
`server`	监听地址、数据根目录、上传限制、CORS、JWT 密钥/有效期、OpenAPI 开关和调试模式
`password`	密码登录开关与最小密码长度
`tha`	代理认证头登录（enabled / headerName / trustedCIDRs）
`oidc`	OIDC 认证（enabled / issuerUrl / clientId / clientSecret / redirectUrl / usernameClaim / scopes / loginLabel）
`passkey`	WebAuthn/Passkey 认证（enabled / rpName / rpId / rpOrigins / timeout）
`copilot`	AI 助手模型接入（model / baseUrl / apiKey）
`apisix`	APISIX Admin API 地址和密钥
`caddy`	Caddy Admin API 地址
`docker`	Docker 守护进程地址、容器数据目录、镜像仓库账号
`monitor`	系统与容器监控的采集间隔（5/15/30/60 秒，其他值禁用自动采集）
`marketplace`	应用市场地址
`links`	自定义快捷链接（名称、URL、图标）
`members`	用户账号、家目录、Founder 标记、路由权限、Passkey 与 TOTP 信息

权限模块

权限基于路由进行细粒度控制。默认的 AccessPerm 路由要求成员持有对应的完整路由权限，Founder 不受此限制；AccessAuth 路由只要登录即可访问，AccessAnon 路由允许匿名访问。

权限格式：<METHOD> /api/<模块>/<路由>（如 GET /api/docker/containers、POST /api/compose/docker）

前端权限判断：使用 portal.hasPerm('<METHOD> /api/<路由>') 控制按钮/操作的显示

留空 = 无 AccessPerm 路由权限；具体可用路由可在登录后通过 GET /api/account/routes 获取。下表列出主要权限点示例。

模块	路由权限点示例	说明
`overview`	`GET /api/overview/version`	系统概览（版本信息）
`overview`	`GET /api/overview/monitor`	系统概览（监控数据）
`overview`	`POST /api/overview/upgrade`	系统概览（在线升级）
`system`	`GET /api/system/config`	系统设置（获取配置）
`system`	`PUT /api/system/config`	系统设置（保存配置）
`system`	`GET /api/system/audit/logs`	系统设置（审计日志）
`account`	`GET /api/account/members`	成员管理（列出）
`account`	`POST /api/account/member`	成员管理（创建）
`account`	`PUT /api/account/member/:username`	成员管理（更新）
`account`	`DELETE /api/account/member/:username`	成员管理（删除）
`account`	`POST /api/account/token`	成员管理（创建 API 令牌）
`account`	`GET /api/account/2fa/status`	二次验证（查询状态）
`account`	`POST /api/account/2fa/totp/begin`	二次验证（开始绑定 TOTP）
`account`	`POST /api/account/2fa/totp/enable`	二次验证（启用 TOTP）
`account`	`POST /api/account/2fa/totp/disable`	二次验证（禁用 TOTP）
`account`	`POST /api/account/passkey/register/begin`	Passkey（开始绑定）
`account`	`POST /api/account/passkey/register/finish`	Passkey（完成绑定）
`account`	`GET /api/account/passkey/credentials`	Passkey（查询凭证列表）
`account`	`PUT /api/account/passkey/credential/:id`	Passkey（重命名凭证）
`account`	`DELETE /api/account/passkey/credential/:id`	Passkey（删除凭证）
`filer`	`GET /api/filer/files`	文件管理（列出）
`filer`	`GET /api/filer/file`	文件管理（读取）
`filer`	`POST /api/filer/file`	文件管理（创建文件）
`filer`	`PUT /api/filer/file`	文件管理（修改）
`filer`	`DELETE /api/filer/file`	文件管理（删除）
`filer`	`POST /api/filer/dir`	文件管理（创建目录）
`filer`	`POST /api/filer/upload`	文件管理（上传）
`filer`	`POST /api/filer/rename`	文件管理（重命名/移动，后端校验目标路径边界）
`filer`	`PUT /api/filer/chmod`	文件管理（修改权限）
`filer`	`POST /api/filer/zip`	文件管理（压缩）
`filer`	`POST /api/filer/unzip`	文件管理（解压）
`shell`	`GET /api/shell`	Web 终端
`ssh`	`GET /api/ssh/hosts`	SSH 远程管理（列出主机）
`ssh`	`GET /api/ssh/credentials`	SSH 远程管理（列出凭据）
`ssh`	`POST /api/ssh/host`	SSH 远程管理（添加主机）
`ssh`	`GET /api/ssh/to/:id`	SSH 远程管理（连接终端）
`ssh`	`GET /api/sftp/:id/ls`	SSH 远程管理（SFTP 列出目录）
`copilot`	`POST /api/copilot/agui`	AI 助手（AG-UI 协议对话）
`cron`	`GET /api/cron/jobs`	计划任务（列出）
`cron`	`POST /api/cron/jobs`	计划任务（创建）
`cron`	`POST /api/cron/jobs/:id/run`	计划任务（立即执行）
`cron`	`GET /api/cron/jobs/:id/logs`	计划任务（查看日志）
`apisix`	`GET /api/apisix/routes`	APISIX 管理（路由列出）
`apisix`	`GET /api/apisix/consumers`	APISIX 管理（消费者列出）
`apisix`	`GET /api/apisix/upstreams`	APISIX 管理（上游列出）
`apisix`	`GET /api/apisix/ssls`	APISIX 管理（证书列出）
`apisix`	`GET /api/apisix/plugin-configs`	APISIX 管理（插件配置列出）
`apisix`	`GET /api/apisix/whitelist`	APISIX 管理（访问授权列出）
`docker`	`GET /api/docker/info`	Docker 管理（服务信息）
`docker`	`GET /api/docker/containers`	Docker 管理（容器列出）
`docker`	`GET /api/docker/images`	Docker 管理（镜像列出）
`docker`	`GET /api/docker/networks`	Docker 管理（网络列出）
`docker`	`GET /api/docker/volumes`	Docker 管理（卷列出）
`docker`	`GET /api/docker/registries`	Docker 管理（镜像仓库列出）
`swarm`	`GET /api/swarm/info`	Swarm 管理（集群信息）
`swarm`	`GET /api/swarm/nodes`	Swarm 管理（节点列出）
`swarm`	`GET /api/swarm/services`	Swarm 管理（服务列出）
`swarm`	`GET /api/swarm/tasks`	Swarm 管理（任务列出）
`compose`	`GET /api/compose/docker/:name`	Compose 管理（读取配置）
`compose`	`POST /api/compose/docker`	Compose 管理（部署）
`compose`	`PUT /api/compose/docker/:name`	Compose 管理（重部署）
`compose`	`GET /api/compose/swarm/:name`	Compose 管理（读取配置）
`compose`	`POST /api/compose/swarm`	Compose 管理（部署）
`compose`	`PUT /api/compose/swarm/:name`	Compose 管理（重部署）
`caddy`	`GET /api/caddy/info`	Caddy 管理（概览）
`caddy`	`GET /api/caddy/config`	Caddy 管理（读取原始配置）
`caddy`	`POST /api/caddy/config`	Caddy 管理（整体替换配置）
`caddy`	`GET /api/caddy/global`	Caddy 管理（读取全局选项）
`caddy`	`PUT /api/caddy/global`	Caddy 管理（更新全局选项）
`caddy`	`GET /api/caddy/servers`	Caddy 管理（HTTP 服务列出）
`caddy`	`GET /api/caddy/routes`	Caddy 管理（路由列出）
`caddy`	`GET /api/caddy/basic-auth`	Caddy 管理（Basic Auth 路由列出）
`caddy`	`GET /api/caddy/certs`	Caddy 管理（证书列出）
`caddy`	`POST /api/caddy/cert`	Caddy 管理（创建证书）
`caddy`	`PUT /api/caddy/cert/:key`	Caddy 管理（更新证书）
`caddy`	`DELETE /api/caddy/cert/:key`	Caddy 管理（删除证书）

GPU 监控

支持自动检测 NVIDIA / AMD / Intel / Apple Silicon 独立显卡，显示使用率、显存、温度、功耗、风扇转速。

厂商	首选方式	回退方式
NVIDIA	nvidia-smi	—
AMD	sysfs	rocm-smi
Intel	sysfs	—
Apple Silicon	ioreg	—

自动过滤虚拟显卡和 Intel 核显（Intel Arc 独显保留）；无独立显存的 AMD APU 通常会在采集时自然跳过。

Docker 部署注意事项

NVIDIA：

docker run -d --gpus all rehiy/isrvd:slim

AMD / Intel：

docker run -d --device /dev/dri:/dev/dri rehiy/isrvd:slim

架构设计

分层架构

cmd/server ────────────→ config + internal/registry + internal/server
config ──────────────────→ pkgs/cstore
internal/registry ───────→ config + pkgs/{apisix,caddy,docker,swarm}
internal/service/* ───────→ config / internal/registry / pkgs/*
internal/server ─────────→ config + internal/registry + internal/service/* + pkgs/* + public

cmd/server：按 config.Init → registry.Init → server.StartApp 启动应用
config：通过 CONFIG_PATH 加载和保存本地 YAML 或 etcd 配置
internal/registry：根据配置初始化 APISIX、Caddy、Docker 和 Swarm 底层实例
pkgs：底层客户端、存储适配和 SDK 类型转换，不依赖 internal
internal/service：业务组合、参数校验与稳定 API 类型转换
internal/server：Gin HTTP/WebSocket 入口、路由、中间件、服务生命周期和响应封装

设计原则

高内聚：同一领域功能聚合在同一包
低耦合：层间通过接口解耦
单一职责：Handler 只管 HTTP，Service 只管业务

开发规范

后端分层：pkgs 保持原生客户端能力，service 负责业务组合与类型转换，server 只处理 HTTP 入出口
前端结构：webview/src/service/types 按域拆分类型，页面复用统一卡片、表格、移动端双视图和操作按钮语义色
状态与权限：全局状态通过 Pinia usePortal() 聚合访问，权限统一使用 portal.hasPerm(moduleOrRoute) 判断
安全基线：敏感字段不返回明文，文件路径与解压路径必须校验，WebSocket 必须经过认证链路
完整规范：根规范见 AGENTS.md，前端专项规范见 webview/AGENTS.md

安全特性

JWT 认证，敏感字段（密钥、密码）不返回前端
文件路径校验，防止目录遍历攻击
解压校验路径，防止 Zip Slip 攻击
WebSocket 连接需经过认证中间件
基于路由的细粒度权限控制，路由访问级别支持 0 需权限、1 需登录、-1 匿名
操作审计日志，路由审计级别支持 0 按 Method、-1 忽略、1 强制记录，默认记录非 GET 请求与 WebSocket 连接
支持可限制代理来源 CIDR 的信任 Header 认证（tha.headerName）

许可证

本项目基于 Apache License 2.0 发布，详见 LICENSE。

第三方组件协议详见 NOTICE。