hlink威联通NAS部署教程：解决重启后配置丢失的完美方案

【免费下载链接】hlink批量、快速硬链工具(The batch, fast hard link toolkit)项目地址: https://gitcode.com/gh_mirrors/hl/hlink

hlink是一款批量、快速硬链工具，能帮助威联通NAS用户高效管理文件链接。本教程将详细介绍如何在威联通NAS上正确部署hlink，并彻底解决重启后配置丢失的问题，让你的文件硬链管理更稳定可靠。

一、为什么威联通NAS需要特殊部署hlink？

威联通NAS系统有其特殊性，直接使用root用户登录安装hlink会导致严重问题：关机重启后所有配置都会被重置！这是因为威联通系统对root权限下的配置文件有特殊处理机制。因此，我们需要采用专门的部署方案来确保hlink配置的持久化。

二、前期准备：创建专用用户

威联通用户不要使用root用户直接登录安装hlink，建议按以下步骤创建专用用户：

1. 登录威联通NAS管理界面
2. 进入"控制面板" > "用户账号"
3. 点击"新增用户"，创建一个具有管理员权限的专用用户（如"hlinkadmin"）
4. 为该用户分配适当的文件访问权限

三、通过Container Station部署hlink（推荐）

使用Docker容器部署是避免配置丢失的最佳方案，威联通的Container Station提供了友好的容器管理界面：

操作步骤：

1. 打开Container Station，点击左侧"创建"按钮
2. 在右侧搜索框输入"hlink"或直接使用以下命令拉取镜像：

   docker pull gitcode.com/gh_mirrors/hl/hlink

3. 点击"创建应用程序"，按照向导完成容器配置
4. 关键步骤：在"存储"选项中，将容器内的配置目录映射到NAS的持久化存储位置（如/share/CACHEDEV1_DATA/hlink/config）
5. 完成创建并启动容器

四、传统部署方式：配置开机自动恢复环境变量

如果不使用Docker，可通过配置开机启动脚本来解决环境变量丢失问题：

1. SSH登录威联通机器

使用你创建的专用用户通过SSH登录NAS：

ssh hlinkadmin@你的NAS IP地址

2. 挂载系统配置分区

执行以下命令挂载配置分区：

mount $(/sbin/hal_app --get_boot_pd port_id=0)6 /tmp/config

3. 编辑autorun.sh脚本

创建或编辑开机启动脚本：

vim /tmp/config/autorun.sh

添加以下内容（根据实际安装路径调整）：

ln -s /share/CACHEDEV1_DATA/.qpkg/NodeJS/bin/hlink /usr/local/bin/hlink

4. 设置脚本执行权限

chmod +x /tmp/config/autorun.sh

5. 开启用户自定义脚本

在威联通管理界面中：

1. 进入"控制台" > "系统" > "硬件"
2. 找到"启动时运行用户定义的进程"选项并勾选
3. 点击"应用"保存设置

6. 卸载配置分区

umount /tmp/config

五、验证部署结果

完成部署后，建议进行以下验证：

1. 执行hlink --version检查是否能正常调用命令
2. 创建一个简单的硬链任务测试功能是否正常
3. 重启NAS后再次检查hlink配置和任务是否保留

六、常见问题解决

Q: 重启后hlink命令找不到怎么办？

A: 检查autorun.sh中的路径是否正确，确保NodeJS和hlink的安装路径与脚本中一致。

Q: Docker部署时配置文件保存在哪里？

A: 配置文件保存在你设置的NAS本地映射目录中，通常建议放在/share/你的共享文件夹/hlink/config。

Q: 如何更新hlink到最新版本？

A: Docker部署可直接拉取最新镜像并重建容器；传统部署可使用npm update -g hlink命令更新。

通过以上方法，你可以在威联通NAS上稳定部署hlink，彻底解决重启后配置丢失的问题。如有更多疑问，可参考项目官方文档docs/other/qnap.md获取详细信息。

【免费下载链接】hlink批量、快速硬链工具(The batch, fast hard link toolkit)项目地址: https://gitcode.com/gh_mirrors/hl/hlink