mirror of
https://github.com/okxlin/appstore.git
synced 2026-09-23 00:00:59 +00:00
55 lines
3.3 KiB
Markdown
55 lines
3.3 KiB
Markdown
# ServerKit
|
||
|
||
## 产品介绍
|
||
|
||
ServerKit 是一个自托管的远程服务器管理与运维面板，提供服务器接入、集群视图、终端、部署、监控、备份、安全和站点相关功能。
|
||
|
||
本应用包使用上游发布的 all-in-one Docker 镜像 `jhd3197/serverkit`，包含 API、前端 SPA 和 Socket.IO 服务。
|
||
|
||
## 主要功能
|
||
|
||
- 接入和管理远程服务器及服务器集群。
|
||
- 提供终端、部署、监控、备份和安全相关能力。
|
||
- 通过浏览器提供统一的 Web 面板和实时 Socket.IO 通信。
|
||
|
||
## 适配说明
|
||
|
||
这是 ServerKit 的容器化部署。容器默认不挂载 Docker Socket、宿主机文件系统或特权权限，因此它不能管理当前 1Panel 宿主机的 systemd、宿主机 Nginx、宿主机软件包或本机站点。它适合评估、管理其他已接入的远程服务器，以及放在反向代理后使用。
|
||
|
||
## 首次使用
|
||
|
||
1. 安装时填写三个唯一密钥：`SECRET_KEY`、`JWT_SECRET_KEY` 和 Fernet 格式的 `SERVERKIT_ENCRYPTION_KEY`。
|
||
2. Fernet 密钥可用以下命令生成：
|
||
|
||
```bash
|
||
python3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"
|
||
```
|
||
|
||
前两个密钥可用 `openssl rand -hex 32` 生成。密钥应妥善保存；更换它们会使已有会话或加密数据失效。
|
||
3. 通过安装时配置的 HTTP 端口打开 ServerKit。首次打开时使用注册页面创建第一个用户；第一个用户会被授予管理员角色。
|
||
4. 如果使用反向代理，请填写 `SERVERKIT_PUBLIC_URL`，并仅在请求一定经过可信反向代理时将 `TRUST_PROXY_HEADERS` 设为 `true`。需要同时允许多个浏览器来源时，在 `CORS_ORIGINS` 中用逗号分隔填写。
|
||
|
||
SQLite 数据库持久化在应用安装目录的 `data/serverkit.db`，并以 bind mount 映射到容器内的 `/app/instance`。该目录位于 1Panel 应用目录中，便于随应用数据一起备份。不要删除该目录，否则会丢失 ServerKit 数据。由旧版 `serverkit-data` 卷升级时，目标版本会在新目录为空时自动迁移 SQLite 文件；旧卷会保留，不会自动删除。
|
||
|
||
## 安全提示
|
||
|
||
维护侧使用 Trivy 对 `serverkit` 的每个版本镜像进行了漏洞扫描；当前每个扫描报告包含 Critical=5、High=77、Total=82（两个版本标签解析到相同镜像内容）。这些风险来自上游镜像及其基础系统组件，本应用包未对其进行修复。请优先在可信内网中使用，并关注上游镜像更新。
|
||
|
||
高风险示例：
|
||
|
||
- Critical `CVE-2025-7458`（`libsqlite3-0`）：当前暂无修复版本。
|
||
- Critical `CVE-2026-13221`、`CVE-2026-42496`、`CVE-2026-8376`（`perl-base`）：当前暂无修复版本。
|
||
- Critical `CVE-2023-45853`（`zlib1g`）：当前暂无修复版本。
|
||
|
||
## 版本
|
||
|
||
应用同时提供 `latest` 和固定版本 `1.11.4`，两者均来自上游 Docker Hub 发布镜像，并支持 amd64 与 arm64。
|
||
|
||
## 相关链接
|
||
|
||
- [上游项目](https://github.com/jhd3197/ServerKit)
|
||
- [Docker 部署文档](https://github.com/jhd3197/ServerKit/blob/v1.11.4/docs/INSTALLATION.md#quick-install-docker)
|
||
- [上游 Compose 文件](https://github.com/jhd3197/ServerKit/blob/v1.11.4/docker-compose.yml)
|
||
|
||
ServerKit 上游项目采用 MIT License，详细条款见[上游许可证](https://github.com/jhd3197/ServerKit/blob/v1.11.4/LICENSE)。
|