一键把 SMB 共享变成网页文件管理器，手机也能直接使用
简介
什么是 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 更快捷
●●●
# 新建文件夹 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:stabledocker-compose 安装
也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件
●●●
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 登录到您的群晖，执行下面的命令：
●●●
# 新建文件夹 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 辅助程序，由它在本地作为服务与浏览器通信
注意事项
-
SMB 访问依赖服务端：访问局域网
SMB共享由Sambee容器内的服务端组件完成，请确保群晖能访问到目标SMB服务器（网络/防火墙放行）。 -
本地磁盘需 Companion：访问本机磁盘不是由容器直接完成的，而依赖在电脑上运行的 Sambee Companion，仅部署容器无法直接浏览本机文件。
-
数据持久化：务必挂载
/app/data卷，否则重启后数据库（含账号、连接配置、目录缓存）会丢失。 -
安全建议：默认
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/
@所有人：写文不易，如果你都看到了这里，请点个赞和在看，分享给更多的朋友；为确保你能收到每一篇文章，请主页右上角设置星标。