Openship自托管部署平台完整指南：2026年如何5分钟部署第一个应用
【免费下载链接】openshipSelf-hosted deployment platform项目地址: https://gitcode.com/GitHub_Trending/ope/openship
Openship 是一款开源免费的自托管部署平台（Self-hosted deployment platform），内置 CI/CD：把代码仓库指向它，它就能自动完成构建、部署、路由和 HTTPS 证书签发。无论你是独立开发者还是小团队，都可以用自己的服务器跑起一套完整的"部署 + 域名 + SSL + 邮件 + 备份"体系。本指南带你5 分钟部署第一个应用，从零开始、无需复杂配置。
三种安装方式：如何安装自托管部署平台
| 你的场景 | 推荐方式 | 特点 |
|---|---|---|
| 个人使用、不想运维 | 桌面应用 | 控制平面只跑在你本机，通过 SSH 管理服务器，无公网暴露 |
| 团队 / 需要 push-to-deploy | 自托管服务器（openship up） | 常驻 Linux 盒子，带登录与邀请机制 |
| 什么都不想管 | Openship Cloud | 官方托管沙箱，零配置 |
方式一：CLI 一键安装（最常用）
在 Linux / macOS 服务器上执行：
curl -fsSL https://get.openship.io | sh # 或 npm i -g openship（需 Node 22+） openship # 交互式向导：建管理员、绑域名、装成开机服务安装脚本会自动携带 Node 运行环境；Linux 上装了 Docker 时，openship up会默认以Compose 模式拉起完整栈（Postgres、Redis、API、仪表盘 + OpenResty 边缘代理，80/443 端口），并自动签发 Let's Encrypt 证书。
方式二：纯 Docker Compose 部署
适合不想装 CLI 的纯 Docker 用户（需 Linux，边缘容器使用 host 网络）：
git clone https://gitcode.com/GitHub_Trending/ope/openship && cd openship cp .env.example .env # 按需修改 docker compose --env-file .env -f docker/docker-compose.yml up -d编排文件位于 docker/docker-compose.yml，栈内包含postgres + redis + api + dashboard + edge五个容器。
完整的安装选项与故障排查（如 Postgres 启动问题）见官方安装文档：docs/installation.md。
5分钟部署第一个应用：完整步骤
第 1 步：启动并打开仪表盘
openship # 向导中创建管理员账号（姓名、邮箱、密码） openship open # 浏览器打开 http://localhost:3001，用管理员登录向导会自动把 Openship 注册为开机自启服务（API 端口:4000，仪表盘:3001），全程无需手写配置文件。
第 2 步：新建项目，指向你的代码
在仪表盘点New project，选择来源：
- GitHub 仓库：首次使用需点Connect GitHub授权一次，之后即可从仓库列表直接选应用；
- 本地文件夹：直接拖入磁盘上的项目目录。
Openship 会自动检测你的技术栈——读package.json、框架配置、锁文件，推断出包管理器、构建/启动命令和端口（Next.js、Nuxt、Django、Spring Boot、Go、Rust 等零配置即识别）。
第 3 步：点 Deploy，看实时构建日志
确认自动生成的配置后直接点Deploy：安装 → 构建 → 容器化运行 → 边缘路由 + TLS。构建页会像"透过烤箱玻璃门看进度"一样流式输出日志，完成后给你一个可访问的 URL。🎉
偏好终端？在项目目录里两条命令搞定：
cd your-project openship init # 把当前目录关联到某个项目 openship deploy # 构建并上线（--watch 可跟随日志）仓库里 fixtures/ 目录提供了 Node、Python FastAPI、Go、Spring Boot 等十余种示例项目，可以直接拿去练手，例如 fixtures/node/server.js 和 fixtures/python-fastapi/main.py。
自托管部署平台核心功能清单
| 能力 | 说明 |
|---|---|
| 🚀 内置 CI/CD | Push-to-deploy（GitHub webhook）、预览环境、staging/prod 流程、一键回滚 |
| 🌍 任意技术栈 | Node、Python、Go、Rust、PHP、Ruby、Java、.NET、Docker、Monorepo |
| 🛢️ 完整后端 | Postgres、MySQL、MongoDB、Redis、Workers、WebSockets、对象存储 |
| 🔒 域名与 SSL | Let's Encrypt 自动签发、泛域名、无限域名、自动续期 |
| ⚡ CDN | 边缘缓存、HTTP/3、Brotli 压缩、即时清除 |
| 📧 邮件服务器 | 内置 SMTP，DKIM/SPF/DMARC 全齐，告别 Mailgun/SES |
| 💾 备份 | 定时策略、数据库+卷备份、一键恢复 |
| 📊 实时监控 | 实时构建日志、容器指标、访客地理分布，单请求开销约 1.4µs 且零数据库写入 |
内置邮件服务器与 AI 能力
除了部署应用，Openship 还自带一套企业级邮件栈（iRedMail 引擎），收件、发件、Webmail 一站式，甚至内置了自然语言 AI 助手——直接"让 AI 帮你回复邮件、找发票、安排会议"。架构细节可参考官方架构图：
常见问题速查
openship open提示 API 无响应？平台还没起来，先跑openship up，稍等几秒再试；随时用openship status检查状态。- 构建失败了？打开构建页看最后几行红色日志——新手失败 90% 是缺构建命令、缺环境变量或监听端口不对。
- 忘了管理员密码？在服务器上执行
openship reset-admin-password，无需登录即可重置。 - 常用命令：
openship stop停止 ·openship update升级 ·openship logs <id> -f跟踪日志 ·openship doctor自检。
文档与源码导航
想继续深入，这些仓库内的资料值得收藏：
- 入门：apps/web/content/docs/getting-started/quickstart.mdx（快速上手）、apps/web/content/docs/getting-started/first-deployment.mdx（首次部署详解）
- 指南：apps/web/content/docs/guides/deploy-from-github.mdx（GitHub 自动部署）、apps/web/content/docs/guides/backups-restore.mdx（备份恢复）
- 专题文档：docs/installation.md（安装）、docs/acme.md（自定义证书机构）、docs/monitoring.md（监控原理）
- 源码结构：API 控制平面在 apps/api/src/，CLI 在 apps/cli/src/，部署适配器架构说明见 packages/adapters/docs/ARCHITECTURE.md
Openship 自托管完全免费、无计费模块，采用 Apache 2.0 许可证。现在打开终端，5 分钟后你就拥有了自己的部署平台。🚀
【免费下载链接】openshipSelf-hosted deployment platform项目地址: https://gitcode.com/GitHub_Trending/ope/openship
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
