首次部署

本指南将带你完成在 Senate 上部署第一个应用的全过程。完成后，你就能通过 URL 访问自己的服务了。

准备工作

• Senate 已安装并运行（参考快速开始）
• 准备好 Docker 镜像、Dockerfile 或包含应用的 Git 仓库

第一步：创建服务

1. 在面板中点击一台服务器
2. 在侧边栏点击添加服务
3. 在弹窗中输入服务名称（比如 my-app）
4. 选择服务类型：Docker 或 Docker Compose
5. 点击创建

第二步：配置部署源

Senate 支持多种部署方式：

方式一：Docker 镜像

最简单直接——使用 Docker Hub 或私有镜像仓库中现成的镜像。

1. 进入 Source 标签页
2. 选择 Docker Image
3. 填入镜像名（如 nginx:latest 或 ghcr.io/your-org/your-app:v1）
4. 点击保存

方式二：Dockerfile

从仓库中的 Dockerfile 直接构建镜像。

1. 进入 Source 标签页
2. 选择 Dockerfile
3. 粘贴 Dockerfile 内容，或关联 Git 仓库
4. 点击保存

方式三：Git 仓库

直接从包含 Dockerfile 的 Git 仓库拉取并构建。

1. 进入 Source 标签页
2. 选择 Git Repository
3. 填入仓库地址
4. 如果是私有仓库，配置认证信息：
   • SSH 密钥：用于 SSH 协议
   • 访问令牌：用于 HTTPS 协议
5. 可选：指定分支和 Dockerfile 路径
6. 点击保存

第三步：开始部署

1. 点击服务顶部的部署按钮
2. 实时查看部署进度
3. 在 Deployments 标签页查看详细构建日志

部署流程：

1. 拉取/构建：下载镜像或从源码构建
2. 创建容器：创建新的 Docker 容器
3. 启动服务：启动容器
4. 健康检查：确认容器正常运行（如已配置）

第四步：访问应用

部署成功后，你的应用就在 Docker 容器里跑起来了。接下来让它能被访问到：

内网访问

同一台服务器上的其他服务可以通过 Docker 网络直接访问：

• 主机名：{service-name}-{id}

公网访问

要把服务暴露到互联网：

1. 进入 Domains 标签页
2. 点击添加域名
3. 输入你的域名（如 app.yourdomain.com）
4. Senate 会自动帮你：
   • 配置 Caddy 反向代理
   • 通过 Let's Encrypt 申请 SSL 证书
   • 把流量转发到你的容器

接下来

服务跑起来之后，可以继续探索这些功能：

• 环境变量 - 配置密钥和参数
• 自定义域名 - 配置 SSL 和域名
• 持久存储 - 挂载数据卷
• 监控 - 查看日志和性能指标