Docker 容器持久化浏览器登录会话
问题现场
容器里跑着一个带浏览器的自动化任务: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 crawlerdocker run -d --name crawler -v /data/chromium-profile:/root/.config/chromium crawler:latestdocker 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 目录等于一份凭证,挂载到宿主机的目录权限要收紧,别随手放在共享目录里。
- 点赞
- 收藏
- 关注作者
评论(0)