项目介绍
通过容器运行 Chromium,可以在 NAS 上保留独立的浏览器环境。下面介绍容器配置、项目目录、网页访问和持久化检查。浏览器中的登录状态属于私人数据,应随配置目录一起妥善保存。
services:
chromium:
image: linuxserver/chromium:latest
container_name: chromium
environment:
- PUID=1000
- PGID=1000
- TZ=Asia/Shanghai
- LC_ALL=zh_CN.UTF-8
- CHROME_CLI=https://www.baidu.com
volumes:
- ./config:/config
ports:
- "13001:3001" #3001是https
shm_size: "1gb"
restart: unless-stopped:::
使用
浏览器中输入 https://NAS的IP:13001 就能看到界面,注意是 HTTPS 协议,不支持http协议
补充:部署与使用
安装与使用步骤
- 创建
/volume1/docker/chromium/config。通过id 你的用户名获取对该目录有读写权限的 UID 和 GID,在项目.env中设置PUID=实际UID、PGID=实际GID。 - 按下面配置启动,先在可信局域网打开
https://NAS_IP:3101。内置证书可能出现提示;远程使用应通过可信 HTTPS 与认证入口。 - 先浏览公开页面,检查输入、下载与剪贴板操作。书签和浏览器配置保存在
/config,重启后确认仍能读到。 - 需要硬件加速时再按设备与项目文档添加 GPU 映射,不一开始就开启特权模式或关闭全部沙箱。
首次使用与操作检查
打开公开测试页,下载一个小文件并建立书签,重启后检查保留。
不能直接套桌面浏览器端口。管理入口增加受控访问,GPU 只在需要时按文档配置。
Docker Compose
依据 LinuxServer 官方 README 的端口、共享内存与 /config 挂载整理。本示例 PUID、PGID 已写为 0;没有配置认证前仅在可信局域网访问。
群晖目录准备
在群晖 SSH 终端执行下面这一段,再将下方配置保存为 /volume1/docker/chromium/compose.yaml。也可在 Container Manager 中新建项目,选择该目录并粘贴配置。
sudo sh <<'HALO_PREPARE'
set -eu
mkdir -p /volume1/docker/chromium /volume1/docker/chromium/config
cd /volume1/docker/chromium
HALO_PREPARE
cd /volume1/docker/chromium
本示例使用数值 0 访问挂载目录,无需查询或填写 UID/GID。
services:
chromium:
image: lscr.io/linuxserver/chromium:latest
restart: unless-stopped
environment:
PUID: "0"
PGID: "0"
TZ: Asia/Shanghai
ports:
- "3100:3000"
- "3101:3001"
shm_size: "1gb"
volumes:
- /volume1/docker/chromium/config:/config
在项目目录保存为 compose.yaml 后,先检查配置,再启动:
docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100
配置与常见问题
- 共享内存设为 1 GB,需要给 NAS 留出相应运行资源;内存不足时先减少标签页。
- 这个页面可操作完整浏览器,不能作为无密码的公网工具开放。
- 页面无法打开:先用
docker compose ps检查状态,再核对宿主机端口、NAS 防火墙与应用日志。不要把容器端口随意改成另一个数字。 - 文件无法保存:核对宿主目录是否存在、挂载方向及运行用户的读写权限。不要直接给整个存储卷开放所有权限。
更新与备份
备份 config 目录时按账号资料处理,可能包含 Cookie、历史记录和登录状态。
更新前保留原配置和数据备份,阅读所用版本的升级说明;确认兼容后再执行 docker compose pull 和 docker compose up -d。只回退镜像不一定能回退已经迁移过的数据库。