Playwright持久化上下文在Docker中无法维持Instagram登录状态

问题描述 #

本地使用包含已登录Instagram账号的Chromium user-data文件夹，通过Playwright持久化上下文启动浏览器能正常保持登录状态；但将代码打包到Docker容器运行后，截图显示未登录状态。

可能原因 #

1. Chrome版本不兼容：本地登录时使用的Chrome版本与Docker容器中Playwright安装的Chrome版本不一致，Chromium的用户数据与版本强绑定，跨版本无法识别会话。
2. 文件权限问题：Docker容器内默认以root用户运行，playwright_data文件夹的权限设置导致Chrome无法正常读取或写入用户数据。
3. 无头模式环境差异：Docker中默认使用无头模式，与本地有头模式的浏览器指纹（如屏幕分辨率、自动化特征）不一致，触发Instagram的登录验证。
4. 用户数据未完整复制：构建镜像时，user-data文件夹中的隐藏文件（如会话缓存）未被完整复制到容器内。

解决方案 #

1. 对齐Chrome版本 #

• 先查看本地Chrome版本：

  # Windows需定位到Chrome安装目录执行，或在浏览器设置中查看版本号
  chrome --version
  

• 修改Dockerfile，安装与本地一致版本的Chrome：

  FROM python:3.12.4
  WORKDIR /app
  COPY . /app
  RUN pip install pytest-playwright
  # 替换为本地Chrome的版本号，例如132.0.0.0
  RUN playwright install chrome@132.0.0.0
  CMD ["python", "main.py"]
  

2. 修复文件权限 #

方式一：直接开放文件夹权限

在Dockerfile中添加权限设置：

FROM python:3.12.4
WORKDIR /app
COPY . /app
RUN pip install pytest-playwright
RUN playwright install chrome
# 开放playwright_data文件夹的读写权限
RUN chmod -R 777 /app/playwright_data
CMD ["python", "main.py"]

方式二：使用非root用户运行

避免root权限导致的文件访问问题：

FROM python:3.12.4
WORKDIR /app
COPY . /app
RUN pip install pytest-playwright
RUN playwright install chrome
# 创建非root用户并赋予文件夹权限
RUN useradd -m appuser
RUN chown -R appuser:appuser /app
USER appuser
CMD ["python", "main.py"]

3. 优化无头模式参数 #

调整Playwright启动参数，模拟更接近本地有头环境的浏览器特征：
修改main.py中的launch_persistent_context配置：

import os
import time
from playwright.sync_api import sync_playwright
ua = "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/132.0.0.0 Safari/537.36"
user_dir = os.path.join(os.getcwd(), "playwright_data")
with sync_playwright() as p:
    browser = p.chromium.launch_persistent_context(
        user_data_dir=user_dir,
        channel="chrome",
        user_agent=ua,
        headless="new",  # 使用新版无头模式，更接近有头浏览器
        args=[
            "--start-maximized",
            "--disable-blink-features=AutomationControlled",  # 禁用自动化检测特征
            "--no-sandbox",  # Docker环境必需参数
            "--disable-dev-shm-usage"  # 解决容器内存限制问题
        ]
    )
    page = browser.new_page()
    page.set_viewport_size({"width": 1920, "height": 1080})  # 设置与本地一致的屏幕分辨率
    page.goto("https://www.instagram.com/" , timeout=300000)
    page.wait_for_load_state("networkidle", timeout=300000)
    page.screenshot(path="screenshot.png")
    time.sleep(300000)

4. 确保用户数据完整复制 #

修改Dockerfile，明确复制playwright_data文件夹的所有内容（包括隐藏文件）：

FROM python:3.12.4
WORKDIR /app
# 先复制用户数据文件夹，确保所有隐藏文件被包含
COPY playwright_data /app/playwright_data
COPY main.py /app/
RUN pip install pytest-playwright
RUN playwright install chrome
CMD ["python", "main.py"]

验证步骤 #

1. 重新构建镜像：docker build -t myapp .
2. 运行容器：docker run -d --name mycont myapp
3. 等待脚本执行后，复制截图：docker cp mycont:/app/screenshot.png ./dockerss.png
4. 检查截图是否显示已登录状态，若仍有问题，可查看容器日志：docker logs mycont排查是否有文件读取或Chrome启动报错。

内容的提问来源于stack exchange，提问作者Asmit Karmakar