LocalSendNAS使用方法详解

LocalSend不仅能作为一款轻量级局域网文件传输工具，更可深度融入NAS系统，变身高效、免登录、免配置的智能文件交互前端：通过CLI+systemd在无GUI环境下稳定后台运行，将接收目录直挂NAS数据卷实现零拷贝落盘，借助反向代理无缝集成至DSM/QTS等Web管理门户，利用内置历史记录构建可检索的时间线索引，并联动rsync与inotify实现“接收即归档”的自动化文件生命周期管理——让老旧NAS焕发新生，让每一次拖拽上传都成为智能存储流程的起点。

如果您希望将LocalSend作为NAS设备的轻量级文件交互前端，实现免登录、免配置的局域网直传访问，则需绕过传统NAS Web管理界面，利用其系统底层能力暴露LocalSend服务。以下是实现此目标的具体操作路径：

一、在Linux NAS上以无GUI模式运行LocalSend

多数家用NAS（如群晖Synology、威联通QNAP、或基于Debian/Ubuntu的自建NAS）支持SSH登录与后台服务部署。LocalSend提供官方CLI版本，可在无桌面环境的NAS中作为系统服务长期运行，从而替代WebDAV或SMB协议进行快速拖拽式文件收发。

1、通过SSH登录NAS，确认系统架构（执行uname -m），下载对应架构的LocalSend CLI二进制文件（如amd64/arm64）。

2、使用wget命令获取最新版CLI：执行wget https://github.com/localsend/localsend/releases/download/v1.12.0/localsend_1.12.0_linux_amd64.tar.gz（版本号依实际发布更新）。

3、解压并赋予可执行权限：tar -xzf localsend_*.tar.gz && chmod +x localsend。

4、创建专用运行目录并移动二进制文件：sudo mkdir -p /opt/localsend && sudo mv localsend /opt/localsend/。

5、新建systemd服务单元文件：sudo nano /etc/systemd/system/localsend.service，填入标准守护进程配置，指定监听地址为0.0.0.0:51000并启用历史记录持久化路径。

6、启用并启动服务：sudo systemctl daemon-reload && sudo systemctl enable localsend && sudo systemctl start localsend。

7、验证服务状态：sudo systemctl status localsend，确认显示active (running)且端口51000处于LISTEN状态。

二、将NAS共享目录挂载为LocalSend默认接收路径

LocalSend默认保存文件至用户主目录下的Downloads子目录，但NAS场景下需将其指向已配置好的数据卷（如/volume1/video或/mnt/md0/public），确保传输文件直接落盘至RAID阵列，避免二次拷贝与空间浪费。

1、编辑LocalSend服务配置，在systemd单元文件的ExecStart=行末尾追加参数--downloads-dir "/volume1/localsend-in"（路径按实际NAS卷结构替换）。

2、手动创建该目录并赋权：sudo mkdir -p /volume1/localsend-in && sudo chown nobody:nogroup /volume1/localsend-in && sudo chmod 775 /volume1/localsend-in。

3、重启服务使路径生效：sudo systemctl restart localsend。

4、在NAS防火墙或路由器中放行TCP端口51000，确保同一局域网内设备可发现并连接该服务。

5、从Windows或Android设备打开LocalSend客户端，在“发送”页点击“搜索设备”，即可自动列出NAS主机名及IP，选择后即可向/volume1/localsend-in直传文件。

三、通过反向代理将LocalSend集成至NAS Web管理门户

为统一入口管理，可将LocalSend的Web界面（运行于51000端口）通过NAS内置Nginx或Apache反向代理至子路径（如https://nas.local/localsend），使其外观与DSM/QTS风格一致，无需记忆独立端口。

1、登录NAS控制面板，进入“控制台 > 网络 > DSM设置 > 反向代理”，点击新增规则。

2、源设置中填写：来源主机名留空或填*，来源端口填443，来源路径填/localsend。

3、目标设置中填写：目标主机名填localhost，目标端口填51000，目标路径留空。

4、启用HTTP/HTTPS重定向，并勾选“启用SSL”以复用NAS已配置的证书。

5、保存后，在浏览器访问https://nas.local/localsend，即可加载LocalSend Web UI，所有上传文件将按前述配置自动存入NAS指定卷。

6、在LocalSend Web界面中点击“历史记录”，可查看每条传输的发送者设备名、时间戳、文件原始路径与保存绝对路径

四、启用LocalSend历史记录作为NAS简易索引服务

LocalSend客户端本地存储JSON格式的历史记录（含文件名、大小、哈希、接收时间），若将其导出并定期同步至NAS共享文件夹，即可构建基于时间线的轻量级文件索引库，配合grep或jq命令实现快速检索。

1、定位LocalSend历史数据库位置：CLI模式下默认位于$XDG_CONFIG_HOME/localsend/history.json，通常为/root/.config/localsend/history.json（root用户运行时）或/var/services/homes/admin/.config/localsend/history.json（群晖admin用户）。

2、编写定时脚本/usr/local/bin/sync-localsend-history.sh，内容包含：读取history.json → 过滤近7天记录 → 使用jq提取关键字段 → 输出为CSV格式 → 保存至/volume1/backup/localsend_history.csv。

3、添加cron任务：0 2 * * * /usr/local/bin/sync-localsend-history.sh，每日凌晨2点自动更新索引。

4、在NAS文件管理器中打开/volume1/backup/localsend_history.csv，即可用Excel或文本编辑器浏览全部传输事件，每条记录均包含精确到毫秒的时间戳与完整文件路径。

5、如需按文件名模糊搜索，可在SSH中执行：grep -i "report" /volume1/backup/localsend_history.csv，即时返回匹配行。

五、配置LocalSend与Rsync协同实现NAS自动归档

当LocalSend接收目录（如/volume1/localsend-in）积累一定数量文件后，可触发rsync脚本将其分类迁移至长期归档目录（如/volume1/archive/2026/04/），完成“临时接收→自动整理→NAS原生管理”的闭环。

1、创建归档脚本/usr/local/bin/archive-localsend.sh，定义源路径、目标年月路径、文件类型白名单（如*.{jpg,png,mp4,mkv,zip,pdf}）。

2、脚本内使用find命令筛选1小时内新增文件：find /volume1/localsend-in -type f -mmin -60 -name "*.*" -print0。

3、对每个匹配文件执行rsync带时间戳重命名迁移：rsync -av --remove-source-files --suffix "_$(date +\%s)" "$file" "$target_dir/"。

4、设置inotifywait监听/volume1/localsend-in目录事件，一旦有IN_CLOSE_WRITE触发，立即调用上述脚本。

5、安装inotify-tools：sudo apt update && sudo apt install inotify-tools（Debian系）或使用SynoCommunity套件中心安装。

6、启动监听服务并设为开机自启，确保所有经LocalSend传入的文件在1分钟内自动移出接收目录，生成唯一时间戳文件名并归档至NAS标准结构

理论要掌握，实操不能落！以上关于《LocalSendNAS使用方法详解》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！