快速上手

跟着这份指南，几分钟内就能装好 Senate 并部署你的第一个服务。

准备工作

开始之前，确保你有：

• 一台 Linux 服务器（Ubuntu 20.04+、Debian 11+ 或其他主流发行版）
• 已安装 Docker（没有也行，安装脚本会帮你装）
• 至少 512 MB 内存
• Root 或 sudo 权限

安装

一键安装

最简单的方式，一行命令搞定：

sh -c "$(curl -sSL https://get.senate.sh)"

这个脚本会帮你：

1. 检测并安装 Docker（如果还没装的话）
2. 拉取并启动 Senate 容器
3. 在 2999 端口运行 Senate

首次登录

1. 打开浏览器，访问 http://你的服务器IP:2999

2. 首次访问时会让你创建管理员账号

3. 填写邮箱和密码，完成注册

4. 用刚创建的账号登录

添加服务器

Senate 可以管理本地和远程服务器上的 Docker 容器。

本地服务器

本地服务器会自动添加，启动 Senate 后就能在面板看到，不用手动配置。

Senate 会自动连接本地 Docker 并开始监控。

远程服务器

添加远程服务器的步骤：

1. 进入 服务器 → 添加服务器
2. 填写服务器信息：
   • 名称：给服务器起个好认的名字
   • 主机：服务器 IP 或域名
   • 端口：SSH 端口（默认 22）
   • 用户名：SSH 登录用户
   • 认证方式：密码或 SSH 密钥
3. 点击 创建

Senate 会通过 SSH 连接到远程服务器，然后就能管理那台服务器上的 Docker 了。

部署第一个服务

服务器准备好之后，就可以部署服务了：

1. 在面板点击要部署的服务器
2. 点击侧边栏的 添加服务
3. 在弹窗中填写服务名称
4. 选择服务类型：
   • Docker：单容器部署
   • Docker Compose：多容器应用
5. 点击 创建
6. 配置部署来源（Docker 镜像、Dockerfile 或 Git 仓库）
7. 点击 部署

绑定域名

想用自定义域名访问服务？

1. 进入服务的 域名 页签
2. 点击 添加域名
3. 输入你的域名
4. 配置选项：
   • 端口：容器暴露的端口
   • SSL：开启自动 HTTPS
5. 点击 保存

Senate 内置的 Caddy 网关会自动帮你：

• 配置反向代理
• 从 Let's Encrypt 申请 SSL 证书
• 把流量转发到你的容器

监控

Senate 提供全方位的实时监控：

• 服务器监控：CPU、内存、磁盘、网络流量
• 容器监控：每个容器的资源占用
• 日志：实时查看容器和部署日志
• 终端：网页版终端，直接进入容器

接下来

• 在 面板 查看所有服务器和服务的状态
• 给服务配置 环境变量

需要帮助？

• GitHub Issues：反馈 Bug 或提需求
• 讨论区：交流问题和想法