NAS 与运维

Chromium:在 NAS 中运行浏览器

  • 0 次阅读
  • 0 条评论
文章摘要

Chromium 的 LinuxServer 容器把浏览器运行在 NAS 上,通过网页桌面访问。适合需要独立浏览环境的任务;浏览器会使用 NAS 的网络,网页桌面端口本身也需要受控访问。 浏览器进程在 NAS 执行,网页桌面把画面和输入交给用户。下载与配置写到容器映射目录,实际联网来自 NAS。 适合独立浏览环境。先测试公开页面和文件保存,再决定是否使用账号。

项目介绍

通过容器运行 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协议

补充:部署与使用

安装与使用步骤

  1. 创建 /volume1/docker/chromium/config。通过 id 你的用户名 获取对该目录有读写权限的 UID 和 GID,在项目 .env 中设置 PUID=实际UID、PGID=实际GID。
  2. 按下面配置启动,先在可信局域网打开 https://NAS_IP:3101。内置证书可能出现提示;远程使用应通过可信 HTTPS 与认证入口。
  3. 先浏览公开页面,检查输入、下载与剪贴板操作。书签和浏览器配置保存在 /config,重启后确认仍能读到。
  4. 需要硬件加速时再按设备与项目文档添加 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。只回退镜像不一定能回退已经迁移过的数据库。

参考资料