简介什么是 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是一个把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# 修改目录权限chmodarw data# 一键启动dockerrun-d\--namesambee\--restartunless-stopped\-p8890:8000\-v$(pwd)/data:/app/data\ghcr.io/helgeklein/sambee:stabledocker-compose 安装也可以用docker-compose安装将下面的内容保存为docker-compose.yml文件version:3.8services:sambee:image:ghcr.io/helgeklein/sambee:stablecontainer_name:sambeerestart:unless-stoppedports:-8890:8000volumes:-./data:/app/data# 数据持久化目录含数据库与缓存# 如需自定义配置取消下面一行注释并放置 config.toml# - ./config.toml:/app/config.toml:ro然后通过SSH登录到您的群晖执行下面的命令# 新建文件夹 sambee 和 子目录mkdir-p/volume1/docker/sambee/data# 进入 sambee 目录cd/volume1/docker/sambee# 修改目录权限chmodarw data# 将 docker-compose.yml 放入当前目录# 一键启动docker-composeup-d运行在浏览器中访问http://群晖IP:8890即可进入Web界面默认初始管理员用户名为admin密码则需要在日志中找登录成功后的主界面点红色的adding your first SMB network share点Add Connection添加要访问的SMB 共享填写服务器地址、共享名、账号密码等Connection name用于标识此连接的名称HostSMB服务器的IP地址或主机名Share name服务器上共享的名称User name如果需要请使用DOMAIN\USER格式PasswordSMB帐户的密码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/sambeeSambee 官方网站地址https://sambee.netSambee 用户指南地址https://sambee.net/docs/user-guide/Sambee 管理员指南地址https://sambee.net/docs/admin-guide/