Cloud in a Bottle 快速开始:3 步部署个人云空间,托管实例与 VPS 怎么选
Cloud in a Bottle 快速开始:3 步部署个人云空间,托管实例与 VPS 怎么选
Cloud in a Bottle 是一款开源的自托管个人云平台,让你在自己掌控的服务器上部署、使用和分享 Web 应用:应用、数据和基础设施都归你所有。本文带你用 3 步完成个人云空间部署,并帮你在「托管实例」和「VPS 自建」之间快速选出最适合自己的方案。
Cloud in a Bottle 能为你做什么 📦
- 像装手机 App 一样装软件:从目录一键安装现成应用,或把任意带 cloudinabottle.toml 清单的 Git 仓库变成可部署应用
- 每个应用都有独立子域名:
notes.mydomain.com这样的正式 HTTPS 网址,可直接分享给朋友 - 数据完全自主:所有数据存放在你自己的硬件上,支持加密增量备份
- 默认安全:所有应用路由默认要求管理员登录,权限由路由层统一把关
第一步:先选部署方式——托管实例还是 VPS?🤔
两条路线跑的是完全相同的软件,功能没有任何差别,区别只在「谁来维护服务器」。
| 对比维度 | 托管实例(Managed Instance) | VPS 自建 |
|---|---|---|
| 上手速度 | 5 分钟内开通 | 需要自己准备域名 + DNS 委托 |
| 域名 | 免费获得 johndoe.bottle.cloud 子域名 + TLS 证书 |
必须拥有自己的域名并做 DNS 委托 |
| 服务器要求 | 无需操心,官方提供 VPS、静态 IP、带宽 | Ubuntu 24.04 + 静态公网 IPv4,开放 80/443/53 端口 |
| 日常维护 | 零维护 | 自己负责系统更新与安全 |
| 迁移 | ✅ 可随时迁移到自建 | ✅ 可随时迁回托管 |
- 托管实例详情见 docs/src/setup/managed_instance.md
- VPS 部署指南见 docs/src/setup/cloud_instance.md
怎么选?
- 🎯 新手 / 只想玩应用:选托管实例,跳过所有运维细节,几分钟就能开始装 App
- 🔧 有极客癖 / 想完全掌控:选 VPS 自建,跟着下面 3 步走即可
第二步:3 步部署 VPS 实例(自建路线)⚡
以下流程来自官方 cloud instance 部署文档,全程只需复制几条命令。
1. 把 DNS 整区委托给服务器
Cloud in a Bottle 会为你的域名运行权威 DNS 服务器,因此需要把整个区委托给机器,而不是只加一条 A 记录。在域名服务商处添加两条记录(以 mycooldomain.com、服务器 203.0.113.10 为例):
| 类型 | 名称 | 值 |
|---|---|---|
A |
ns1.mycooldomain.com |
203.0.113.10 |
NS |
mycooldomain.com |
ns1.mycooldomain.com |
委托生效后,每个应用自动获得子域名,通配 TLS 证书也会自动签发,之后你再也不用碰 DNS。
用下面命令确认委托已生效(传播可能需要几分钟到一天):
dig +short NS mycooldomain.com # 应返回 ns1.mycooldomain.com
dig +short A ns1.mycooldomain.com # 应返回 203.0.113.10
2. 运行一键安装脚本
将仓库中的 scripts/provision.sh 安装脚本传到服务器,以 root 执行:
bash provision.sh --domain mycooldomain.com --acme-email you@example.com
常用参数说明:
| 参数 | 作用 |
|---|---|
--domain |
必填。你的域名(或已有域名的子域,如 bottle.mydomain.com) |
--acme-email |
Let's Encrypt 证书注册邮箱 |
--local-http-only |
纯 HTTP 本地模式,适合还没有公网域名的场景 |
--swap-size |
Swap 大小(GiB),小内存机器可调小 |
脚本会自动完成:创建低权限 host 用户 → 安装 rootless Podman 与 pixi → 拉取源码 → 生成配置 → 注册 Let's Encrypt 账户 → 启动 openhost 服务,全程无需手工配置。
3. 打开 Claim URL 认领实例
公网可达的实例是「令牌门控」的,防止被陌生人抢先占领。安装结束时终端会打印:
Claim URL: https://mycooldomain.com/setup?claim=<token>
打开它,创建管理员账号即完成认领。如果证书还在签发,稍等一分钟刷新即可 🎉
💡 家里没有静态公网 IP?可先以本地 HTTP 模式启动,再通过 Cloudflare Tunnel 或 Tailscale 暴露到公网,方案见 docs/src/setup/home_network.md;整台机器专属跑它的家庭服务器流程见 docs/src/setup/dedicated_homeserver.md。
第三步:开始使用你的个人云 🚀
日常操作全部在 https://<你的域名>/ 的 Dashboard 完成(详见 docs/src/operation/overview.md):
| 页面 | 用途 |
|---|---|
| Dashboard | 所有应用、运行状态与入口 |
| Catalog | 应用商店,一键安装现成应用 |
| Settings | 账号、API 令牌、域名、归档存储、平台更新 |
| System info | 内存 / 磁盘 / 各应用资源占用 |
| Terminal | 浏览器里直接开 Shell |
装第一个应用有 3 种方式:
- 从目录:打开 Catalog,找到应用点 Install,一路填好即可
- 从 Git 仓库:Deploy app → 粘贴任意含
cloudinabottle.toml的仓库地址,路由会自动克隆、构建镜像、启动容器 - 从应用定义文件:导入别人导出的 YAML 定义,批量部署
安装前页面会展示应用申请的权限(内存、数据目录、跨应用服务等),确认后才授予,默认所有应用权限最小化。应用启动后即拥有 https://<应用名>.<你的域名>/ 的正式网址,可分享给任何设备访问。
别忘了两件事:
- 配置备份应用:基于 restic 的加密增量备份,建议指向实例外的 S3 存储
- 习惯终端的话可安装
bottleCLI,无需浏览器完成部署、看日志等操作,见 docs/src/operation/cli.md
常见问题 FAQ ❓
Q1:服务器最低需要什么配置?
一台全新 Ubuntu 24.04、静态公网 IPv4,入站开放 80/tcp、443/tcp、53/tcp+udp(注意云厂商安全组),根文件系统为 ext4 / xfs / btrfs。托管实例则无需考虑这些。
Q2:托管实例和自建能互相迁移吗? 可以。两者软件完全一致,用备份应用的迁移页把应用清单和永久数据搬到另一台实例即可,随时双向切换。
Q3:应用怎么访问跨应用服务(如 Secrets、OAuth)? 通过清单声明权限并批准后,容器间通过内置服务机制调用,规范见 docs/src/creating_an_app/cross_app_services.md 与 docs/src/creating_an_app/manifest_spec.md。
Q4:想看看源码或参与开发?
git clone https://gitcode.com/gh_mirrors/cl/cloud-in-a-bottle
核心路由逻辑在 compute_space/,部署 Playbook 在 ansible/,完整架构说明见 docs/src/how_it_works/overview.md。
写在最后 ✅
3 步回顾:选路线 → 委托 DNS + 一条命令安装 → 认领并装应用。不管选托管实例还是 VPS,你的个人云空间都会稳稳落在你自己掌控的硬件上。祝部署顺利!
