Skip to content

Add Dockerfile for installing and running in Docker | 增加dockerfile,支持在docker中安装运行 #3389

Closed

Description

@ranxianglei

增加dockerfile,支持在docker中安装运行

Activity

  1. ranxianglei commented on Oct 16, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    (ai: vllm-qwen/qwen3.8-27b)

    查重:不重复。 按 docker/container 关键词检索 open+closed issues/PR:无既有的「加 Dockerfile / 官方镜像跑 bili」请求。相关但不同:#3341(有用户自行手搓 Docker 部署并遇到 Node 20 启动崩溃——证明该需求真实存在,也钉死了基础镜像选择下限);#697(CI 里的 docker 仅用于跑 codex e2e 测试,与产品部署无关)。

    功能类审核:

    1. 合理性——成立。 用户已经在自己往容器里部署 bili(Node 20 Docker startup segfaults after SQLite self-bootstrap #3341 就是一例);没有官方入口时每个用户都要自己猜基础镜像、端口、数据目录和更新行为。bili 本身是长驻 HTTP 代理服务(8787 端口 + Web 管理界面),容器化是它的自然部署形态。
    2. 系统设计——契合现有架构,零新增配置面。 每个决策点都有现成机制:
      • 基础镜像 node:24-slim:SQLite 引擎梯度的首选是内置 node:sqlite(Node ≥ 22.5),24-slim 直接命中,容器内完全不发生 native addon 下载;Node 20 Docker startup segfaults after SQLite self-bootstrap #3341 实测 24-slim 启动正常、Node 20 直接崩(自举下载的 better-sqlite3@13 声明要求 Node ≥ 22)。
      • 容器内自动更新默认关闭(ACP_AUTO_UPDATE=0,现有 env var,无需新配置面):按 Install-Lane 契约,容器化副本的合法升级通道是镜像重建/pull;原地自更新会改容器文件系统,而容器重建后静默回退到镜像版本 = 静默版本漂移。想要容器内自更新可显式 -e ACP_AUTO_UPDATE=1 打开。
      • 端口/卷/健康检查全走现有表面:EXPOSE 8787 + --host 0.0.0.0(README 已写明远程访问无认证、仅限可信网络);四个 XDG 目录(config/data/cache/state,src/paths.ts 定义)声明为 VOLUME;健康检查用 node 内置 fetch 探 /__bili/health,slim 镜像无需装 curl。
    3. 耦合——不污染边界。 Dockerfile 构建期从 npm 装已发布包(发布的 dist 才是被测试过的产物,容器里不编译源码),不 COPY 仓库任何源码;.dockerignore 把构建上下文缩到只剩 Dockerfile 本身。

    方案(照此推进,owner 可随时异议): 仓库根加 Dockerfile + .dockerignore,README en/zh 各加一节「Running in Docker」(构建/运行示例、卷映射、更新策略、安全注意),PR 正文引用 Closes #3389。范围外:CI 自动构建/推送镜像到 registry(需要定发布去处 ghcr.io / Docker Hub 等,属后续单独决策项)。

    开始动手,完成后贴八问结论 + PR 链接。

  2. changed the title [-]增加dockerfile,支持在docker中安装运行[/-] [+]Add Dockerfile for installing and running in Docker | 增加dockerfile,支持在docker中安装运行[/+] on Oct 16, 2026
  3. ranxianglei commented on Oct 16, 2026

    @ranxianglei
    OwnerAuthor

    🤖 Powered by ework · qwen3.8-27b

    (ai: vllm-qwen/qwen3.8-27b)

    做完了,PR: https://github.com/ranxianglei/billion-context/pull/3392(分支 2026-10-16_dockerfile,单提交)

    内容:仓库根目录 Dockerfile + .dockerignore + 中英 README 各一节。docker build -t billion-context . && docker run -p 8787:8787 ... 即得可用代理,客户端 baseURL 指到 http://<host>:8787/bili/... 即可。

    结构化八问

    1. 是什么问题:项目没有官方的 Docker 运行方式——想用容器的用户只能自己手写镜像(Node 20 Docker startup segfaults after SQLite self-bootstrap #3341 就是实例:有人手搓后踩了 Node 版本的坑)。
    2. 什么原因导致的:不是 bug,是能力缺口——仓库从未提供过 Dockerfile;已有的相关 docker 只是 CI 跑 E2E 测试用的(test: add containerized real-codex E2E (docker) (#686) #697),不算产品部署支持。
    3. 影响范围与严重程度:对现有用户零影响(本次不改任何源码,只新增文件+文档);对容器用户是从「自己摸索、有坑」到「官方镜像」。
    4. 怎么修复的:构建期安装已发布的 npm 包(被测试过的产物,镜像里不编译任何东西);基础镜像 node:24-slim,直接用内置 node:sqlite(免下载 native addon,同时避开 Node 20 Docker startup segfaults after SQLite self-bootstrap #3341 的 Node 20 崩溃);四个数据目录声明为 VOLUME;自带健康检查;文档覆盖挂载、更新、安全注意事项。
    5. 是否有回归问题:无——零源码改动,不触碰任何既有行为。已按镜像同款环境变量与启动参数,用发布产物 v0.1.197 本地定向验证通过:1 秒内健康检查就绪、存储引擎为 node:sqlite/builtin、状态全部落在声明的四个目录内、SIGTERM 干净退出;全量套件由 CI 在推送 head 上把关。
    6. 是否破坏缓存:不涉及——未触碰任何缓存/去重/增量游标逻辑。
    7. 是否改了设计方向:不涉及——全部复用现有机制(npm 安装、XDG 目录布局、健康端点、自更新开关),无新架构或数据流。
    8. 是否引入了新的配置:无新增配置项。一个需要明示的行为默认:容器镜像内默认关闭自更新(ACP_AUTO_UPDATE=0)——非容器场景行为完全不变。理由:容器化副本的正规升级通道是重建/pull 新镜像,原地自更新会在下次重建时被静默回退到镜像版本,造成版本漂移;想开回来加 -e ACP_AUTO_UPDATE=1,构建期钉版本用 --build-arg BILI_VERSION=x.y.z(默认 latest)。

    范围外:CI 自动构建并推送镜像到 registry(ghcr.io 还是别处需要你拍板)——需要时单开 issue。

    判定:可 review 合并;mergeable 状态与 CI 结果以 GitHub 页面为准。

  4. added
    其他改动范围:内核之外的主机侧接线(src/agent 适配器、server 路由、注入拦截)/范围兜底/客户端标签
    on Oct 18, 2026
  5. added a commit that references this issue on Oct 20, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    p3其他改动范围:内核之外的主机侧接线(src/agent 适配器、server 路由、注入拦截)/范围兜底/客户端标签

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions