【免费下载链接】cloud-in-a-bottleDeploy, use, and share web apps on a server you control. Your apps, data, and infrastructure stay yours.项目地址https://gitcode.com/gh_mirrors/cl/cloud-in-a-bottle点击查看免费下载Cloud in a Bottle 是一个自托管的 Web 应用部署平台你在自己控制的服务器上运行它就能一键部署、使用和分享各类 Web 应用。应用上线的那一刻平台router会自动向容器注入一整组BOTTLE_*环境变量并挂载好数据目录。这套注入机制就是应用与平台之间的契约——读环境变量拿路径、拿身份、拿令牌而不是硬编码。本文用一张速查表讲清所有环境变量与三层数据目录让你的应用开箱即用。 契约速览平台给了你什么部署一个应用只需在仓库根目录放一个cloudinabottle.toml清单完整字段见 manifest_spec.md。平台完成容器构建后会自动注入三类信息身份与令牌应用名、不可变 App ID、跨应用调用令牌路由信息内部 Router 地址、实例域名数据目录持久 / 临时 / 归档三层挂载点全部挂载在容器的/data/下。环境变量的注入逻辑在 data.py 中完成容器启动与挂载由 containers.py 管理rootless Podman每个应用只能看到自己被授权的目录。 身份与路由类环境变量清单变量示例用途BOTTLE_APP_NAMEmy-app应用名即路由子域名BOTTLE_APP_ID4Hm9pX2Qk7Lt不可变的应用唯一 IDbase58重命名后依然稳定适合做持久数据的键BOTTLE_APP_TOKENkF3xP_2qA-...每次部署随机生成的应用令牌用于跨应用服务调用详见下文BOTTLE_ROUTER_URLhttp://host.containers.internal:8080Router 内部地址构造服务请求的入口BOTTLE_LOCAL_PORT9137仅network_host应用注入须绑定此宿主机端口而非清单端口BOTTLE_ZONE_DOMAINmycooldomain.com实例的域名BOTTLE_MY_REDIRECT_DOMAINmy.selfhost.imbue.com共享的 OAuth 重定向域名BOTTLE_OWNER_USERNAMEalice实例所有者的显示名可用于预置 SSO 账户名兼容提示项目曾用名 OpenHost因此每个OPENHOST_*变量都会自动生成对应的BOTTLE_*别名见 containers.py 中的add_bottle_env_aliases()。新旧两套名字值相同新应用建议统一使用BOTTLE_*。 数据目录三层结构与环境变量所有数据目录都挂载在容器内/data/下但应用应始终从环境变量读取路径不要硬编码。三层存储的定位如下详见 data.md层级环境变量容器内路径适合存什么持久数据默认开启BOTTLE_APP_DATA_DIR/data/app_data/appSQLite 数据库、笔记、配置、小文件临时数据需app_temp_data trueBOTTLE_APP_TEMP_DIR/data/app_temp_data/app缩略图、转码产物、构建缓存等可再生数据归档数据需app_archive trueBOTTLE_APP_ARCHIVE_DIR/data/app_archive/app照片、视频、附件等大文件可配置为 S3 JuiceFS 后端弹性扩展SQLite 数据库路径也是注入的在清单中声明[data] sqlite [main]后平台会预留数据库文件路径并通过BOTTLE_SQLITE_MAIN注入注意文件本身不预创建由你的应用首次初始化时创建从而正确触发建表逻辑BOTTLE_SQLITE_MAIN/data/app_data/my-app/sqlite/main.db特殊权限访问所有应用的数据文件浏览器、备份工具这类应用可声明access_all_app_data true挂载所有应用的全部三层目录如仓库内置的 file_browser 清单。此时BOTTLE_APP_DATA_DIR、BOTTLE_APP_TEMP_DIR、BOTTLE_APP_ARCHIVE_DIR会同时注入。 用契约做跨应用服务调用BOTTLE_APP_TOKEN是跨应用集成的钥匙。调用其他应用暴露的服务时向 Router 发起请求并带上令牌即可curl -X POST $BOTTLE_ROUTER_URL/api/services/v2/call/secrets/get \ -H Authorization: Bearer $BOTTLE_APP_TOKEN \ -H Content-Type: application/json \ -d {keys: [MY_API_KEY]}完整流程、权限模型与X-OpenHost-*请求头说明见 cross_app_services.md服务接口的头字段实现位于 headers.py。✅ 最佳实践清单只信环境变量路径、域名、端口全部来自BOTTLE_*保证迁移、重命名、多实例下行为一致用BOTTLE_APP_ID而不是BOTTLE_APP_NAME做持久键重命名应用时 ID 不变数据库放持久层SQLite / RocksDB 等需要严格 POSIX 语义的数据库属于app_data大文件放归档层索引留在持久层令牌安全BOTTLE_APP_TOKEN每次部署都会重新生成切勿写死在代码或镜像里非 HTTP 端口走清单[[ports]]声明如 SMTP常规 HTTP 流量无需额外配置Router 会自动把{app_name}.{zone_domain}代理进来。 延伸阅读应用开发总览overview.md清单字段完整参考manifest_spec.md数据与存储分层data.md跨应用服务契约cross_app_services.md环境注入源码data.py、containers.py掌握这套环境变量 数据目录契约后你的应用就获得了在任意 Cloud in a Bottle 实例上无感部署的能力——剩下的交给平台吧。赞分享【免费下载链接】cloud-in-a-bottleDeploy, use, and share web apps on a server you control. Your apps, data, and infrastructure stay yours.项目地址https://gitcode.com/gh_mirrors/cl/cloud-in-a-bottle点击查看免费下载相关推荐Tsuru环境变量注入工具配置与使用完整指南Tsuru环境变量注入工具配置与使用完整指南 Tsuru作为一个开源且可扩展的PaaS平台提供了强大的环境变量管理功能让开发者能够轻松配置应用程序的运行环后端云原生容器编排DevOpsWoodpecker 接入 Bitbucket Cloud 完整指南OAuth 注册、环境变量配置与源码实现解析Woodpecker 接入 Bitbucket Cloud 完整指南OAuth 注册、环境变量配置与源码实现解析 本文基于 Woodpecker v3.16CI/CDDevOpsOlares 应用接入 MySQL 中间件OlaresManifest 声明、值注入与环境变量映射全解Olares 应用接入 MySQL 中间件OlaresManifest 声明、值注入与环境变量映射全解 在 Olares 上开发或上架应用时关系型数据库的接云原生后端运维创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
【免费下载链接】cloud-in-a-bottleDeploy, use, and share web apps on a server you control. Your apps, data, and infrastructure stay yours.项目地址https://gitcode.com/gh_mirrors/cl/cloud-in-a-bottle点击查看免费下载Cloud in a Bottle 是一个自托管的 Web 应用部署平台你在自己控制的服务器上运行它就能一键部署、使用和分享各类 Web 应用。应用上线的那一刻平台router会自动向容器注入一整组BOTTLE_*环境变量并挂载好数据目录。这套注入机制就是应用与平台之间的契约——读环境变量拿路径、拿身份、拿令牌而不是硬编码。本文用一张速查表讲清所有环境变量与三层数据目录让你的应用开箱即用。 契约速览平台给了你什么部署一个应用只需在仓库根目录放一个cloudinabottle.toml清单完整字段见 manifest_spec.md。平台完成容器构建后会自动注入三类信息身份与令牌应用名、不可变 App ID、跨应用调用令牌路由信息内部 Router 地址、实例域名数据目录持久 / 临时 / 归档三层挂载点全部挂载在容器的/data/下。环境变量的注入逻辑在 data.py 中完成容器启动与挂载由 containers.py 管理rootless Podman每个应用只能看到自己被授权的目录。 身份与路由类环境变量清单变量示例用途BOTTLE_APP_NAMEmy-app应用名即路由子域名BOTTLE_APP_ID4Hm9pX2Qk7Lt不可变的应用唯一 IDbase58重命名后依然稳定适合做持久数据的键BOTTLE_APP_TOKENkF3xP_2qA-...每次部署随机生成的应用令牌用于跨应用服务调用详见下文BOTTLE_ROUTER_URLhttp://host.containers.internal:8080Router 内部地址构造服务请求的入口BOTTLE_LOCAL_PORT9137仅network_host应用注入须绑定此宿主机端口而非清单端口BOTTLE_ZONE_DOMAINmycooldomain.com实例的域名BOTTLE_MY_REDIRECT_DOMAINmy.selfhost.imbue.com共享的 OAuth 重定向域名BOTTLE_OWNER_USERNAMEalice实例所有者的显示名可用于预置 SSO 账户名兼容提示项目曾用名 OpenHost因此每个OPENHOST_*变量都会自动生成对应的BOTTLE_*别名见 containers.py 中的add_bottle_env_aliases()。新旧两套名字值相同新应用建议统一使用BOTTLE_*。 数据目录三层结构与环境变量所有数据目录都挂载在容器内/data/下但应用应始终从环境变量读取路径不要硬编码。三层存储的定位如下详见 data.md层级环境变量容器内路径适合存什么持久数据默认开启BOTTLE_APP_DATA_DIR/data/app_data/appSQLite 数据库、笔记、配置、小文件临时数据需app_temp_data trueBOTTLE_APP_TEMP_DIR/data/app_temp_data/app缩略图、转码产物、构建缓存等可再生数据归档数据需app_archive trueBOTTLE_APP_ARCHIVE_DIR/data/app_archive/app照片、视频、附件等大文件可配置为 S3 JuiceFS 后端弹性扩展SQLite 数据库路径也是注入的在清单中声明[data] sqlite [main]后平台会预留数据库文件路径并通过BOTTLE_SQLITE_MAIN注入注意文件本身不预创建由你的应用首次初始化时创建从而正确触发建表逻辑BOTTLE_SQLITE_MAIN/data/app_data/my-app/sqlite/main.db特殊权限访问所有应用的数据文件浏览器、备份工具这类应用可声明access_all_app_data true挂载所有应用的全部三层目录如仓库内置的 file_browser 清单。此时BOTTLE_APP_DATA_DIR、BOTTLE_APP_TEMP_DIR、BOTTLE_APP_ARCHIVE_DIR会同时注入。 用契约做跨应用服务调用BOTTLE_APP_TOKEN是跨应用集成的钥匙。调用其他应用暴露的服务时向 Router 发起请求并带上令牌即可curl -X POST $BOTTLE_ROUTER_URL/api/services/v2/call/secrets/get \ -H Authorization: Bearer $BOTTLE_APP_TOKEN \ -H Content-Type: application/json \ -d {keys: [MY_API_KEY]}完整流程、权限模型与X-OpenHost-*请求头说明见 cross_app_services.md服务接口的头字段实现位于 headers.py。✅ 最佳实践清单只信环境变量路径、域名、端口全部来自BOTTLE_*保证迁移、重命名、多实例下行为一致用BOTTLE_APP_ID而不是BOTTLE_APP_NAME做持久键重命名应用时 ID 不变数据库放持久层SQLite / RocksDB 等需要严格 POSIX 语义的数据库属于app_data大文件放归档层索引留在持久层令牌安全BOTTLE_APP_TOKEN每次部署都会重新生成切勿写死在代码或镜像里非 HTTP 端口走清单[[ports]]声明如 SMTP常规 HTTP 流量无需额外配置Router 会自动把{app_name}.{zone_domain}代理进来。 延伸阅读应用开发总览overview.md清单字段完整参考manifest_spec.md数据与存储分层data.md跨应用服务契约cross_app_services.md环境注入源码data.py、containers.py掌握这套环境变量 数据目录契约后你的应用就获得了在任意 Cloud in a Bottle 实例上无感部署的能力——剩下的交给平台吧。赞分享【免费下载链接】cloud-in-a-bottleDeploy, use, and share web apps on a server you control. Your apps, data, and infrastructure stay yours.项目地址https://gitcode.com/gh_mirrors/cl/cloud-in-a-bottle点击查看免费下载相关推荐Tsuru环境变量注入工具配置与使用完整指南Tsuru环境变量注入工具配置与使用完整指南 Tsuru作为一个开源且可扩展的PaaS平台提供了强大的环境变量管理功能让开发者能够轻松配置应用程序的运行环后端云原生容器编排DevOpsWoodpecker 接入 Bitbucket Cloud 完整指南OAuth 注册、环境变量配置与源码实现解析Woodpecker 接入 Bitbucket Cloud 完整指南OAuth 注册、环境变量配置与源码实现解析 本文基于 Woodpecker v3.16CI/CDDevOpsOlares 应用接入 MySQL 中间件OlaresManifest 声明、值注入与环境变量映射全解Olares 应用接入 MySQL 中间件OlaresManifest 声明、值注入与环境变量映射全解 在 Olares 上开发或上架应用时关系型数据库的接云原生后端运维创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
