在飞牛NAS(fnOS)上部署 IT-Tools,可以让你轻松拥有一套自托管的开发者工具箱。这套工具集包含了超过100种实用功能,比如 UUID 生成、JSON 格式化、Base64 编解码、时间戳转换等,无需安装任何额外软件,打开浏览器即可使用。本文将手把手教你在飞牛NAS的 Docker 环境中完整部署 IT-Tools,并实现外网访问与数据持久化。
前置准备
在开始之前,请确保你的飞牛NAS满足以下条件:
飞牛NAS系统版本建议为最新版,确保应用中心功能正常。已开启 SSH 服务(控制面板 > 终端与SNMP > 启用SSH)。预留至少 1GB 的可用磁盘空间,因为 IT-Tools 镜像本身约 200MB,但 Docker 运行需要额外缓存空间。
如果你尚未安装 Docker,请先前往飞牛NAS的“应用中心”搜索并安装 Docker 应用。安装完成后,建议重启一次NAS以确保环境变量生效。
第一步:通过 SSH 连接飞牛NAS
使用你习惯的 SSH 客户端(如 PuTTY、Termius 或 macOS/Linux 的终端)连接飞牛NAS。连接命令如下:
ssh 你的用户名@你的飞牛NASIP地址
例如 ssh [email protected]。输入密码后,你将进入飞牛NAS的命令行界面。建议先切换到 root 用户以简化后续操作:
sudo -i
注意:如果你的飞牛NAS默认不允许 root 登录,请使用普通用户并配合 sudo 执行每条命令。
为了方便管理配置和后续更新,我们为 IT-Tools 创建一个专用数据目录。在命令行中依次执行:
mkdir -p /volume1/docker/it-tools
cd /volume1/docker/it-tools
这里 /volume1 是飞牛NAS默认的存储池挂载点,如果你的存储池名称不同(比如 /volume2),请相应调整。你也可以将目录放在任意共享文件夹下,例如 /volume1/docker/it-tools 是一个常见选择。
IT-Tools 官方推荐使用 corentinth/it-tools:latest 镜像。我们直接通过 Docker 命令进行部署,无需编写复杂的 docker-compose 文件,非常适合快速上手。
执行以下命令启动容器:
docker run -d \
--name it-tools \
--restart unless-stopped \
-p 8080:80 \
-v /volume1/docker/it-tools:/app/data \
corentinth/it-tools:latest
命令参数说明:
-d 表示后台运行容器。--name it-tools 给容器命名为 it-tools。--restart unless-stopped 保证容器在系统重启或崩溃后自动重启。-p 8080:80 将宿主机的 8080 端口映射到容器内的 80 端口。-v /volume1/docker/it-tools:/app/data 将数据目录挂载到容器内,便于备份和升级。
如果你希望使用其他端口,比如 8899,只需将 8080:80 改为 8899:80 即可。注意不要与飞牛NAS系统端口冲突(如 5000、5001)。
第四步:验证部署是否成功
运行完上述命令后,等待几秒让容器启动。你可以通过以下命令查看容器运行状态:
docker ps | grep it-tools
如果看到类似 CONTAINER ID ... it-tools ... Up ... 的输出,说明容器正在运行。若状态为 Exited,请使用 docker logs it-tools 查看错误日志。
现在,在浏览器中输入 http://你的飞牛NASIP地址:8080,你应该能看到 IT-Tools 的欢迎界面,一个简洁的深色主题主页,上面排列着各种工具分类图标。
第五步:配置反向代理与域名访问(可选)
如果你想通过自定义域名或子路径访问 IT-Tools,可以在飞牛NAS的“应用中心”或使用 Nginx Proxy Manager 进行反向代理设置。这里以飞牛NAS自带的“Web服务”为例(如果可用):
- 进入飞牛NAS控制面板 > 应用中心 > Web服务。
- 点击“添加网站”,选择“反向代理”。
- 设置如下参数:
- 域名:填写你的域名,例如
tools.yourdomain.com
- 目标URL:填写
http://localhost:8080
- 启用SSL:如果你有证书,可以勾选并上传。
- 保存后,等待DNS解析生效,即可通过域名访问。
如果你使用 Nginx Proxy Manager(需自行部署),配置方法类似,只需将 http://NAS_IP:8080 作为转发目标即可。
第六步:升级与维护
IT-Tools 的开发者更新频繁,建议定期检查并升级容器。升级步骤如下:
- 停止并删除旧容器:
bash
docker stop it-tools && docker rm it-tools
- 拉取最新镜像:
bash
docker pull corentinth/it-tools:latest
- 重新运行创建容器的命令(与第三步相同):
bash
docker run -d \
--name it-tools \
--restart unless-stopped \
-p 8080:80 \
-v /volume1/docker/it-tools:/app/data \
corentinth/it-tools:latest
由于数据目录已经挂载,你的设置和偏好会保留。整个过程只需几分钟,且不会丢失任何数据。
第七步:常用工具速览与技巧
部署完成后,你可以立即开始使用 IT-Tools。以下是一些高频工具的快速入口建议:
- UUID生成器:生成 v4/v7 UUID,支持批量生成。
- JSON编辑器:格式化、压缩、校验 JSON,支持树形视图。
- Base64编解码:支持文本和文件的 Base64 转换。
- 时间戳转换:Unix 时间戳与人类可读时间的双向转换。
- 正则表达式测试器:实时匹配结果高亮显示。
- 密码生成器:自定义长度、字符集,生成强密码。
一个小技巧:IT-Tools 支持浏览器端本地运行,所有计算都在你的设备上进行,不经过任何服务器,数据隐私有保障。你甚至可以将其添加到浏览器书签栏,随时调用。
总结
通过以上七个步骤,你已经在飞牛NAS上成功部署了 IT-Tools 开发者工具箱。整个过程只需几分钟,无需复杂的配置。这套工具集对于日常开发、调试、数据处理等场景非常实用,而且完全免费、开源。后续你可以根据需求调整端口、配置域名,或通过升级保持最新功能。现在,打开浏览器访问 http://你的飞牛IP:8080,开始享受一站式工具服务吧。