一键把 SMB 共享变成网页文件管理器，手机也能直接使用

发表于 分类于 Waline： 阅读次数： 本文字数： 2.7k 阅读时长 ≈ 2 分钟
Sambee 是一个浏览器端的文件查看与管理工具，支持 SMB 共享和本地磁盘的快速预览与 Markdown 编辑。

简介

什么是 Sambee ？

Sambee 是一个开源的浏览器端文件查看与管理工具。它可以帮助用户直接在浏览器（包括手机端）中浏览、预览和管理 SMB 网络共享以及本机磁盘上的文件，并可作为 Total Commander 之类双栏文件管理工具的网页替代品。

主要特点

  • SMB 共享与本地磁盘支持：通过服务端组件在浏览器的 HTTP(S) 与文件服务器的 SMB 协议之间做转换，从而访问局域网内的 SMB 共享；本机磁盘则由 Sambee Companion 辅助程序提供访问能力。
  • 单栏 / 双栏视图：支持单栏和双栏浏览模式，在浏览器和手机上都能获得类似桌面文件管理器的操作体验。
  • 快速图片与 PDF 预览：内置高速图片浏览器，支持广泛的文件格式，同时集成 PDF 查看器，所有预览均在浏览器内完成，无需额外软件。
  • Markdown 编辑器：内置 Markdown 编辑与预览功能，可直接在网页端编写和查看 .md 文档。
  • 桌面应用集成：可从浏览器直接调用本机安装的桌面软件（如 Word、Excel、Photoshop）打开文件，编辑完成后自动回传到原存储位置。
  • 开源免费：基于 MIT 协议开源，可免费使用和修改（Sambee 名称及 Logo 为 Helge Klein 的商标，不受 MIT 授权）。

应用场景

  • 家庭 NAS 文件浏览：在群晖等 NAS 上部署后，通过浏览器随时访问局域网内的 SMB 共享，无需安装额外客户端。
  • 手机端移动访问：在手机浏览器中查看、预览 NAS 上的照片和文档，实现”PC 端和手机端一致”的文件访问体验。
  • 团队共享文件管理：配合 SMB 文件服务器，为团队提供轻量的网页端文件查看与管理入口。
  • Markdown 写作：利用内置 Markdown 编辑器，直接在浏览器中撰写和预览笔记、文档。

Sambee界面截图

Sambee 是一个把 SMB 共享和本机磁盘”搬进浏览器”的轻量级文件管理器，让文件访问不再受限于设备和客户端。

安装

在群晖上以 Docker 方式安装。

本文写作时， stable 版本对应为 0.9.37；当然你也可以试试最新的测试版 1.0.7

提示：项目官方镜像托管在 ghcr.io，群晖 Docker 套件无法直接搜索，需要通过命令行拉取镜像，因此仅提供 docker cli 与 docker-compose 两种安装方式。

docker cli 安装

如果你熟悉命令行，可能用 docker cli 更快捷

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
# 新建文件夹 sambee 和 子目录
mkdir -p /volume1/docker/sambee/data

# 进入 sambee 目录
cd /volume1/docker/sambee

# 修改目录权限
chmod a+rw data

# 一键启动
docker run -d \
  --name=sambee \
  --restart=unless-stopped \
  -p 8890:8000 \
  -v $(pwd)/data:/app/data \
  ghcr.io/helgeklein/sambee:stable

docker-compose 安装

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

1
2
3
4
5
6
7
8
9
10
11
12
13
version: '3.8'

services:
  sambee:
    image: ghcr.io/helgeklein/sambee:stable
    container_name: sambee
    restart: unless-stopped
    ports:
      - "8890:8000"
    volumes:
      - ./data:/app/data  # 数据持久化目录（含数据库与缓存）
      # 如需自定义配置，取消下面一行注释并放置 config.toml
      # - ./config.toml:/app/config.toml:ro

然后通过 SSH 登录到您的群晖，执行下面的命令：

1
2
3
4
5
6
7
8
9
10
11
12
13
# 新建文件夹 sambee 和 子目录
mkdir -p /volume1/docker/sambee/data

# 进入 sambee 目录
cd /volume1/docker/sambee

# 修改目录权限
chmod a+rw data

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器中访问 http://<群晖IP>:8890 即可进入 Web 界面

默认初始管理员用户名为 admin，密码则需要在日志中找

登录成功后的主界面，点红色的 adding your first SMB network share

点 Add Connection 添加要访问的 SMB 共享

填写服务器地址、共享名、账号密码等

  • Connection name：用于标识此连接的名称
  • Host：SMB 服务器的 IP 地址或主机名
  • Share name：服务器上共享的名称
  • User name：如果需要，请使用 DOMAIN\USER 格式
  • Password：SMB 帐户的密码
  • Path prefix：共享内的基本路径（可选）

如果设置没问题，就会看到 Samba 中的内容了

进一个目录

进入文件浏览器即可预览图片、PDF，或在线编辑 Markdown 文件

如需访问本机磁盘，还需在电脑上安装 Sambee Companion 辅助程序，由它在本地作为服务与浏览器通信

注意事项

  1. SMB 访问依赖服务端：访问局域网 SMB 共享由 Sambee 容器内的服务端组件完成，请确保群晖能访问到目标 SMB 服务器（网络/防火墙放行）。
  2. 本地磁盘需 Companion：访问本机磁盘不是由容器直接完成的，而依赖在电脑上运行的 Sambee Companion，仅部署容器无法直接浏览本机文件。
  3. 数据持久化：务必挂载 /app/data 卷，否则重启后数据库（含账号、连接配置、目录缓存）会丢失。
  4. 安全建议：默认 JWT 令牌有效期为 24 小时；建议将服务置于反向代理之后并启用 HTTPS，不要在公网裸暴露 8890 端口

参考文档

helgeklein/sambee: Browser-based file viewer and manager for SMB shares and local drives, with fast previews and Markdown editing
地址：https://github.com/helgeklein/sambee

Sambee 官方网站
地址：https://sambee.net

Sambee 用户指南
地址：https://sambee.net/docs/user-guide/

Sambee 管理员指南
地址：https://sambee.net/docs/admin-guide/