Docker 容器持久化浏览器登录会话

举报
yd_254065487 发表于 2026/11/16 05:21:04 2026/11/16
【摘要】 把浏览器 profile 挂载到宿主机,用 sqlite 批量改写会话 cookie 的过期时间,让容器重建后登录态依然有效。

问题现场

容器里跑着一个带浏览器的自动化任务:Playwright 打开站点登录后抓数据。登录态落在 Chromium 的 profile 目录里,/root/.config/chromium。第一版直接跑,docker run 之后登录成功,docker restart 再进去,页面又跳回登录页。

原因不复杂:大多数站点下发的登录 cookie 没有 Expires/Max-Age,属于 session cookie,浏览器进程退出就被丢弃。普通浏览器靠「继续浏览此前打开的标签页」还能恢复,但容器里的浏览器是被强杀的,没有任何恢复机制。而把 profile 挂到宿主机只是保住了文件,保不住 session cookie。真正要做的是让 cookie 本身带过期时间。

第一步:把 profile 挂载到宿主机

挂载目录要避开容器内置的临时层,否则 docker rm 后连 cookie 文件都没了:

  • docker run -d --name crawler -v /data/chromium-profile:/root/.config/chromium crawler:latest
  • 更稳妥的做法是用命名卷:docker volume create chrome-profile,然后 -v chrome-profile:/root/.config/chromium

注意 Chromium 在 profile 目录里会写 SingletonLock、SingletonSocket 这类锁文件,容器异常退出后会残留,下次启动报 Failed to create a ProcessSingleton for your profile directory。entrypoint 里要先清理:rm -f /root/.config/chromium/Singleton*。

第二步:找到 cookie 数据库

Chromium 把 cookie 存在 profile 下的 Default/Cookies,是个 SQLite 文件。容器里没有 sqlite3 的话先装上,Debian 系用 apt-get install -y sqlite3,Alpine 用 apk add sqlite。

先看一眼现状:

  • sqlite3 /root/.config/chromium/Default/Cookies "SELECT host_key,name,expires_utc,is_persistent FROM cookies;"

session cookie 的 is_persistent 是 0,expires_utc 也是 0。要让它持久,把这两列改掉。注意 Chromium 的时间不是 Unix 时间戳,而是自 1601-01-01 起的微秒数。设成一年后可以这样算:

  • exp=$(( ($(date +%s) + 31536000 + 11644473600) * 1000000 ))
  • sqlite3 /root/.config/chromium/Default/Cookies "UPDATE cookies SET is_persistent=1, expires_utc=$exp WHERE is_persistent=0;"

11644473600 是 1601 到 1970 的秒数差,漏掉它 cookie 会变成 1601 年过期,等于立刻失效。改完再查一遍,is_persistent 应全为 1。

第三步:确认顺序,写进 entrypoint

这一步最容易踩坑。Cookies 是 SQLite 数据库,浏览器运行时会持有它并可能把内存里的 cookie 回写磁盘。如果在浏览器已经启动的情况下改库,改动会被覆盖;如果在浏览器退出后、下次启动前改,才是有效的。

所以 entrypoint 的顺序必须是:清理锁文件 → 改 cookie → 启动浏览器。绝不能反过来,也不能在浏览器运行中对同一 profile 做 UPDATE。同时要保证改库时没有其他 Chromium 进程占用该文件,否则 sqlite3 会报 Error: database is locked。可以在改库前加一句 pkill -f chromium || true 兜底并 sleep 1。

把逻辑抽成脚本 /usr/local/bin/fix-cookies.sh,entrypoint 里第一行调用它,再 exec 原有命令。改库只在启动前执行一次,不要放进循环。

第四步:容器重建后验证

重建容器验证登录态:

  • docker rm -f crawler
  • docker run -d --name crawler -v /data/chromium-profile:/root/.config/chromium crawler:latest
  • docker exec crawler sqlite3 /root/.config/chromium/Default/Cookies "SELECT count(*) FROM cookies WHERE is_persistent=0;",结果应为 0

再进浏览器访问一个需要登录的页面,能直接看到用户名或后台内容就说明登录态还在。如果仍然跳登录页,检查两点:一是站点是否用了别的存储(如 localStorage 里的 token),那不走 cookie 这条路;二是 profile 里是否同时存在多个用户目录,路径要对准实际使用的 Default 或 Profile 1。

最后提醒一句:cookie 改写成持久后,过期前会一直有效,profile 目录等于一份凭证,挂载到宿主机的目录权限要收紧,别随手放在共享目录里。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。