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 -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），仅供参考

Openship自托管部署平台完整指南：2026年如何5分钟部署第一个应用