Openship连接自己的VPS教程从SSH接入到首次部署全记录【免费下载链接】openshipSelf-hosted deployment platform项目地址: https://gitcode.com/GitHub_Trending/ope/openshipOpenShip 是一款开源的自托管部署平台Self-hosted deployment platform内置 CI/CD、域名管理与 Lets Encrypt 自动证书。本教程带你从零开始把自己的 VPS 接入 OpenShip先通过 SSH 打通服务器连接再完成人生第一次一键部署。整个过程不需要编写配置文件跟着走即可。开始前的准备一台 VPS 就够了 接入 OpenShip 前请确认以下条件一台可公网访问的 VPSHetzner、DigitalOcean、Linode、OVH 等任意厂商均可OpenShip 对任意 VPS 一视同仁SSH 能登录知道服务器的公网 IP或域名、端口默认 22、用户名常见为root以及密码或私钥路径建议 KVM 类型的 VPS如果使用 OpenVZ/LXC 类虚拟化Postgres 可能启动失败详见文末常见问题域名可选想把项目发布到自定义域名时需提前把 DNS A 记录指向 VPS 公网 IP。 OpenShip 的自托管完全免费无计费、无 license key。两种接入方式如何把 OpenShip 装上你的 VPSOpenShip 有两种控制面形态对应两种玩法完整对比见 docs/installation.md适合人群控制面跑在哪VPS 的角色个人、只有一台机器你的电脑桌面应用通过SSH 远程管理部署项目到 VPS团队 / 需要 push-to-deployVPS 本身openship up既跑控制面也跑你的应用方式一桌面应用 SSH 图形化接入下载对应系统的 OpenShip 桌面应用macOS / Windows / Linux 均支持源码见 apps/desktop/src/main/index.ts首次启动会进入引导流程选择Another Server进入Connect to your server步骤填入 VPS 的主机地址、端口、用户名选择认证方式密码password或密钥key可指定私钥路径与口令甚至支持跳板机jump host点击Test Connection验证连通性。引导流程的每一步状态机逻辑都在 packages/onboarding/src/flow.ts 中定义SSH 参数如何归一化进系统配置可以查看 packages/onboarding/src/ssh.ts。⚠️ 如果填的是内网 IP引导流程会自动多走一步Internet Access为你的服务器配置隧道Cloudflare Tunnel / ngrok保证 Webhook、SSL 验证和公网访问畅通。方式二在 VPS 上用 CLI 一键安装推荐团队使用直接用 SSH 登录 VPS两行命令搞定官方完整指南docs/installation.mdcurl -fsSL https://get.openship.io | sh # 安装 CLI捆绑 API 仪表盘 openship # 交互式向导创建管理员、绑定域名、装成开机服务向导会帮你创建第一个管理员账号、接入域名并把 OpenShip 安装为开机自启服务。后续常用命令一览openship open—— 打开 Web 仪表盘openship status—— 查看运行状态openship update—— 升级平台openship stop—— 停止服务CLI 全部命令实现位于 apps/cli/src/commands/纯 Docker 党也可以直接拉取官方编排文件 docker/docker-compose.yml 手工起栈。首次部署从仓库到线上站点控制面就绪后部署第一个项目只需两步cd your-project openship init # 把当前目录关联为一个项目 openship deploy # 触发部署OpenShip 会自动探测你的技术栈读取package.json、框架配置、锁文件和docker-compose.yml推断出构建命令、启动命令和端口——Node、Python、Go、Rust、PHP、Java、.NET 通吃零配置文件。探测不准时可用openship.json覆盖。部署流水线分为五步Detect探测技术栈Build构建为 Docker 镜像或裸发布配置快照冻结回滚可精确复现Run以容器运行仅监听回环地址不直接暴露端口Route secure由 OpenResty 边缘写入反向代理虚拟主机自动签发 Lets Encrypt 证书——域名或证书问题只会提示需要处理不会导致部署失败Push-to-deploy接入 GitHub Webhook 后每次推送自动重新部署。仪表盘 Web 端源码位于 apps/dashboard/src/app/提供同样的操作界面可以实时看构建日志、管理域名与服务器团队通过邀请制加入。常见问题SSH 连不上或数据库起不来1. SSH 连接失败先手动验证ssh root你的IP。确认端口未被防火墙拦截、密钥路径正确、口令字段已填。若密钥有保护口令别忘了在连接表单里填写 passphrase。2. Postgres 启动报Operation not permitted这是虚拟化/文件系统兼容问题。先清掉半初始化的数据卷再启动docker compose -f docker/docker-compose.yml down -v docker compose --env-file .env -f docker/docker-compose.yml up -d仍失败则检查systemd-detect-virtOpenVZ/LXC 请换 KVM 型 VPS并把 Docker contenteditable="false">【免费下载链接】openshipSelf-hosted deployment platform项目地址: https://gitcode.com/GitHub_Trending/ope/openship创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考