AI浏览器 Docker部署教程｜零基础可学

随着大模型能力不断增强，“AI浏览器”正在成为一个非常实用的工具。它不仅可以像普通浏览器一样打开网页，还可以结合大语言模型，自动完成网页搜索、信息提取、表单填写、页面总结、资料整理等任务。对于想体验 AI Agent、自动化办公、网页自动操作的用户来说，使用 Docker 部署一个 AI 浏览器环境，是目前比较稳定、干净、容易复现的方式。

本文面向零基础用户，带你从安装 Docker 开始，一步一步完成 AI 浏览器的部署、配置和运行。即使你没有太多 Linux 或服务器经验，也可以按照本文完成搭建。

一、什么是 AI 浏览器？

这里所说的 AI 浏览器，通常指的是一种结合了以下能力的浏览器环境：

1. 真实浏览器内核
   例如 Chromium、Chrome 或基于 Playwright / Selenium 控制的浏览器。

2. AI 大模型能力
   可以接入 OpenAI、Claude、Gemini、DeepSeek、通义千问、智谱等模型。

3. 自动化操作能力
   AI 可以根据你的指令自动打开网页、点击按钮、输入内容、提取信息。

4. 可视化界面
   用户可以通过 Web 页面看到任务执行过程，也可以配置模型 API Key、任务提示词等参数。

通俗来说，普通浏览器需要你手动操作，而 AI 浏览器可以在你给出一句话任务后，自动帮你浏览网页并完成指定动作。

例如你可以让它：

帮我打开某个电商网站，搜索机械键盘，并整理前 5 个销量较高的产品名称、价格和链接。

或者：

请打开新闻网站，搜索今天关于人工智能的热点新闻，并总结成 300 字。

二、为什么推荐使用 Docker 部署？

很多 AI 浏览器项目依赖 Python、Node.js、浏览器驱动、系统字体、Playwright、Chromium 等组件。如果直接在本机安装，很容易遇到版本冲突、依赖缺失、环境污染等问题。

Docker 的优势是：

对于零基础用户来说，Docker 是部署这类 AI 应用最省心的方式。

三、部署前准备

在开始之前，你需要准备以下内容。

1. 一台电脑或服务器

可以选择以下任意环境：

• Windows 10 / Windows 11
• macOS
• Linux 服务器，例如 Ubuntu 20.04 / 22.04
• 云服务器，例如阿里云、腾讯云、华为云、Vultr、DigitalOcean 等

如果你只是本地体验，普通电脑即可。

如果你想 24 小时运行，建议使用云服务器。

2. 推荐配置

最低配置：

CPU：2 核
内存：4GB
硬盘：20GB
系统：Ubuntu 20.04 或 Ubuntu 22.04

推荐配置：

CPU：4 核及以上
内存：8GB 及以上
硬盘：40GB 及以上

AI 浏览器通常会启动 Chromium 浏览器，内存占用会比普通 Web 服务更高。如果服务器内存太小，可能出现浏览器崩溃或页面卡顿。

3. 一个大模型 API Key

AI 浏览器本身并不一定内置大模型，通常需要接入第三方模型服务。

常见选择：

本文以通用配置方式讲解，你可以根据实际项目支持的模型填写对应参数。

四、安装 Docker

如果你的电脑或服务器已经安装了 Docker，可以跳过本节。

1. Ubuntu 安装 Docker

在服务器终端执行：

sudo apt update
sudo apt install -y ca-certificates curl gnupg lsb-release

添加 Docker 官方 GPG 密钥：

sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | \
sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg

添加 Docker 软件源：

echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] \
https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

安装 Docker：

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-compose-plugin

检查 Docker 是否安装成功：

docker version

如果可以看到 Docker 的版本信息，说明安装成功。

2. 启动 Docker 服务

sudo systemctl enable docker
sudo systemctl start docker

查看运行状态：

sudo systemctl status docker

如果状态显示为 active running，说明 Docker 正常运行。

3. 免 sudo 使用 Docker

默认情况下，执行 Docker 命令可能需要加 sudo。如果你想直接使用 docker 命令，可以执行：

sudo usermod -aG docker $USER

然后退出终端重新登录，或者执行：

newgrp docker

再次测试：

docker ps

如果没有权限报错，说明配置成功。

五、准备项目目录

为了方便管理，我们创建一个专门的目录来存放 AI 浏览器配置文件。

mkdir -p ~/ai-browser
cd ~/ai-browser

后续所有配置文件都放在这个目录中。

六、编写 Docker Compose 配置

Docker Compose 可以帮助我们用一个配置文件管理多个容器。对于 AI 浏览器来说，通常至少包括一个 Web 服务和一个浏览器运行环境。

下面给出一个通用的 docker-compose.yml 示例。你可以根据所使用的具体 AI 浏览器项目进行调整。

创建文件：

nano docker-compose.yml

写入以下内容：

services:
  ai-browser:
    image: ghcr.io/browser-use/web-ui:latest
    container_name: ai-browser
    restart: unless-stopped
    ports:
      - "7788:7788"
    environment:
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - OPENAI_BASE_URL=${OPENAI_BASE_URL}
      - LLM_MODEL=${LLM_MODEL}
    volumes:
      - ./data:/app/data
    shm_size: "2gb"

说明：
上面的镜像地址以常见的 Browser Use Web UI 类型项目为例。不同 AI 浏览器项目的镜像名称、端口和环境变量可能不同。如果你使用的是其他项目，请以项目官方文档为准。

保存文件：

• 使用 nano 编辑器时，按 Ctrl + O 保存
• 按 Enter 确认
• 按 Ctrl + X 退出

七、配置环境变量

为了避免把 API Key 直接写进 docker-compose.yml，我们可以创建 .env 文件。

执行：

nano .env

写入以下内容：

OPENAI_API_KEY=你的_API_Key
OPENAI_BASE_URL=https://api.openai.com/v1
LLM_MODEL=gpt-4o-mini

如果你使用 DeepSeek，可以写成类似这样：

OPENAI_API_KEY=你的_DeepSeek_API_Key
OPENAI_BASE_URL=https://api.deepseek.com/v1
LLM_MODEL=deepseek-chat

如果你使用支持 OpenAI 兼容接口的国内大模型平台，也可以按照平台文档填写对应的 BASE_URL 和模型名称。

例如：

OPENAI_API_KEY=sk-xxxxxxxxxxxxxxxx
OPENAI_BASE_URL=https://你的模型服务地址/v1
LLM_MODEL=模型名称

注意事项：

1. API Key 不要公开上传到 GitHub。
2. 不要把 .env 文件发给别人。
3. 如果 API Key 泄露，请立即到模型服务商后台删除或重置。

八、启动 AI 浏览器

在 ~/ai-browser 目录下执行：

docker compose up -d

参数说明：

第一次启动时，Docker 会自动下载镜像。根据网络情况，可能需要几分钟。

启动完成后，查看容器状态：

docker ps

如果看到类似内容，说明服务已经运行：

CONTAINER ID   IMAGE                         PORTS
xxxxxxx        ghcr.io/browser-use/web-ui    0.0.0.0:7788->7788/tcp

九、访问 AI 浏览器界面

如果你是在本地电脑部署，打开浏览器访问：

http://localhost:7788

如果你是在服务器部署，访问：

http://服务器公网IP:7788

例如：

http://123.123.123.123:7788

如果无法访问，请检查以下几点：

1. Docker 容器是否正常运行；
2. 云服务器安全组是否放行 7788 端口；
3. 服务器防火墙是否拦截；
4. Compose 文件中的端口映射是否正确。

十、云服务器放行端口

如果你使用的是云服务器，除了系统防火墙，还需要在云厂商控制台放行端口。

以常见配置为例，需要开放：

TCP 7788

来源建议先设置为你的个人 IP，测试没有问题后再根据需要调整。如果直接开放给所有人：

0.0.0.0/0

则任何人都可以访问你的 AI 浏览器界面，存在安全风险。

如果系统启用了 UFW 防火墙，可以执行：

sudo ufw allow 7788/tcp
sudo ufw reload

查看状态：

sudo ufw status

十一、基础使用方法

进入 AI 浏览器页面后，一般会看到任务输入框或模型配置界面。

你可以尝试输入：

请打开百度，搜索“人工智能最新发展”，并总结搜索结果中的主要观点。

或者：

请访问维基百科，搜索 Docker，并用中文解释 Docker 的用途。

对于电商、资讯、文档类网页，也可以尝试：

请打开某个商品网站，搜索无线鼠标，并列出前 5 个商品的名称、价格和链接。

AI 浏览器会根据你的指令自动调用模型，规划操作步骤，然后控制浏览器完成任务。

十二、常用管理命令

1. 查看容器状态

docker ps

2. 查看日志

docker logs -f ai-browser

如果服务启动失败，日志通常能告诉你原因，例如 API Key 错误、模型名称错误、端口冲突等。

3. 停止服务

docker compose down

4. 重启服务

docker compose restart

5. 更新镜像

docker compose pull
docker compose up -d

6. 删除容器和数据

如果你想完全删除：

docker compose down
rm -rf ~/ai-browser

如果还想删除镜像，可以查看镜像：

docker images

然后删除对应镜像：

docker rmi 镜像名称或镜像ID

十三、常见问题与解决方法

问题 1：网页打不开

首先检查容器是否运行：

docker ps

如果没有看到 ai-browser，查看日志：

docker logs ai-browser

也可以尝试重新启动：

docker compose restart

如果是云服务器，请检查安全组是否放行端口。

问题 2：提示 API Key 错误

可能原因：

1. .env 文件中的 API Key 写错；
2. API Key 已过期或额度不足；
3. 使用了错误的 OPENAI_BASE_URL；
4. 模型名称不正确。

修改 .env 文件后，需要重启容器：

docker compose down
docker compose up -d

问题 3：浏览器运行很慢

AI 浏览器通常同时消耗 CPU、内存和网络资源。可以尝试：

1. 升级服务器配置；
2. 使用更轻量的模型；
3. 减少同时执行的任务数量；
4. 增加 Docker 的共享内存设置。

在 Compose 文件中已经配置：

shm_size: "2gb"

如果服务器内存足够，可以适当调大，例如：

shm_size: "4gb"

问题 4：Chromium 崩溃

浏览器崩溃通常和共享内存不足有关。可以检查是否配置了：

shm_size: "2gb"

如果没有，请加上后重启服务。

另外，服务器内存太小也可能导致浏览器崩溃。建议至少使用 4GB 内存，最好 8GB 以上。

问题 5：端口被占用

如果启动时报错提示 port is already allocated，说明 7788 端口已经被其他程序占用。

可以修改 docker-compose.yml：

ports:
  - "8788:7788"

然后访问：

http://服务器IP:8788

修改后重新启动：

docker compose down
docker compose up -d

十四、安全建议

AI 浏览器可以访问网页并执行操作，因此部署时一定要注意安全。

1. 不要公开暴露管理页面

如果没有登录认证，建议不要直接把服务暴露到公网。

更安全的方式是：

• 使用内网访问；
• 使用 VPN；
• 使用 Nginx 反向代理并配置密码；
• 限制安全组来源 IP。

2. 不要让 AI 操作敏感账户

不建议让 AI 浏览器直接登录银行、支付、企业后台等敏感系统。

AI Agent 可能会误操作，因此涉及资金、隐私、账号安全的场景要谨慎。

3. 定期更新镜像

定期执行：

docker compose pull
docker compose up -d

可以获得新功能和安全修复。

4. 妥善保管 API Key

API Key 相当于你的模型账户密码。泄露后，别人可能会消耗你的额度。

建议：

• 不要截图公开；
• 不要上传到公开仓库；
• 定期轮换；
• 设置额度上限。

十五、进阶：使用 Nginx 反向代理

如果你有域名，可以使用 Nginx 把 AI 浏览器绑定到域名上。

例如你的域名是：

ai.example.com

安装 Nginx：

sudo apt install -y nginx

创建配置文件：

sudo nano /etc/nginx/sites-available/ai-browser

写入：

server {
    listen 80;
    server_name ai.example.com;

    location / {
        proxy_pass http://127.0.0.1:7788;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

启用配置：

sudo ln -s /etc/nginx/sites-available/ai-browser /etc/nginx/sites-enabled/
sudo nginx -t
sudo systemctl reload nginx

然后访问：

http://ai.example.com

如果需要 HTTPS，可以使用 Certbot 申请免费证书。

安装 Certbot：

sudo apt install -y certbot python3-certbot-nginx

申请证书：

sudo certbot --nginx -d ai.example.com

根据提示完成即可。

十六、适合 AI 浏览器的使用场景

AI 浏览器非常适合处理重复性强、信息量大、流程固定的网页任务。

常见场景包括：

1. 网页资料收集
   搜索某个主题，并整理多个网页的核心内容。

2. 竞品分析
   打开竞品网站，提取价格、功能、卖点、更新日志等信息。

3. 电商选品
   搜索商品，提取标题、价格、销量、评价等信息。

4. 文档阅读
   打开技术文档，让 AI 总结安装步骤和关键配置。

5. 表格录入辅助
   从网页中提取结构化信息，整理为 CSV 或 Markdown 表格。

6. 自动化测试
   模拟用户点击网页，检查页面流程是否正常。

需要注意的是，AI 浏览器并不是万能的。遇到复杂验证码、强登录限制、动态页面异常或反爬机制时，任务可能失败，需要人工介入。

十七、总结

本文介绍了 AI 浏览器的基本概念，并通过 Docker Compose 演示了从零开始部署 AI 浏览器的完整流程。整体步骤可以概括为：

1. 准备服务器或本地电脑；
2. 安装 Docker 和 Docker Compose；
3. 创建项目目录；
4. 编写 docker-compose.yml；
5. 配置 .env 中的模型 API Key；
6. 启动容器；
7. 通过浏览器访问 Web 界面；
8. 根据实际需求进行安全加固和反向代理配置。

对于零基础用户来说，Docker 部署最大的好处是简单、稳定、方便迁移。只要你理解了配置文件、端口映射和环境变量这几个核心概念，就可以快速部署大多数 AI 工具。

最后提醒：AI 浏览器虽然强大，但在使用时一定要注意隐私、安全和合规，不要让它操作高风险账户，也不要把服务界面直接暴露给陌生人。合理使用 AI 浏览器，可以显著提升资料收集、网页分析和自动化办公效率。