========================================================================
🦅 鹰眼打印 (HawkEye Print) · 群晖 / 飞牛 fnOS / 绿联 / 极空间 NAS 远程打印网关部署教程
官方网站：https://yingyandayin.com
========================================================================

【一、功能简介】
将本压缩包部署在您家里的 NAS（群晖 Synology、飞牛 fnOS、威联通 QNAP、绿联、极空间等）上，即可实现 365 天 × 24 小时超低功耗无人值守远程打印！
无论您在全球任何地方，只需打开手机【鹰眼打印 App】输入 NAS 网关生成的 6 位配对码，即可把微信/手机里的文档、作业试卷直接发回家里的兄弟（Brother）等打印机自动出纸！
* 承诺：作为家中打印网关 100% 永久免费，不限时长、不限接收打印页数！

------------------------------------------------------------------------
【方案 A：群晖 Synology 最稳最快部署法（免 Docker，利用内置 Python3 任务计划，10 秒搞定！）】
------------------------------------------------------------------------
群晖 DSM 7.x 系统原生自带 Python 3，完全不需要折腾 Docker 镜像源，推荐直接用【任务计划】部署：
1. 打开群晖【File Station（文件管理）】，将本压缩包解压上传到任意共享文件夹，例如：
   `/volume1/docker/hawkeye/` （确保 `lasersharp_gateway.py` 和 `start_nas_background.sh` 在该目录内）。
   * 提示：可在 File Station 中右键点击 `lasersharp_gateway.py` ->【属性】，复制上面的完整「位置」路径。
2. 打开群晖【控制面板】 -> 【任务计划】。
3. 点击顶部【新增】 -> 【触发的任务】 -> 【用户定义的脚本】：
   - 常规设置：任务名称填 `hawkeye_gateway`，用户账号选 `root`，事件选 `开机`。
   - 任务设置（运行命令）：在下方「用户定义的脚本」框中输入：
     `nohup python3 /volume1/docker/hawkeye/lasersharp_gateway.py --headless --web-port 19180 >/dev/null 2>&1 &`
     （注意将 `/volume1/docker/hawkeye` 替换为您实际存放的文件夹路径）
4. 点击确定保存，然后选中刚才创建的 `hawkeye_gateway` 任务，点击顶部【运行】按钮！
5. 打开电脑或手机浏览器，访问：`http://您的群晖IP:19180` （例如 `http://192.168.1.100:19180`）：
   - 页面上会直接显示 **6 位数字配对码** 和二维码！
   - 若自动扫描未找到打印机，可在该网页底部直接输入家里打印机的 IP（如 `192.168.1.150`）点击【手动保存IP】。

------------------------------------------------------------------------
【方案 B：飞牛私有云 (fnOS) / 群晖 Container Manager (Docker Compose 容器部署法)】
------------------------------------------------------------------------
如果您使用的是 **飞牛 fnOS** 或习惯使用 Docker Compose：
1. 在飞牛 fnOS（或群晖）的文件管理中，新建一个文件夹（如 `/docker/hawkeye`），将本压缩包内的所有文件（`docker-compose.yml`、`Dockerfile`、`lasersharp_gateway.py`）解压上传到该文件夹内。
2. 打开飞牛 fnOS 的 **【Docker】** 应用（群晖为 **【Container Manager】**） -> 切换到左侧 **【Compose / 项目】** -> 点击 **【新增项目】**：
   - 项目名称：填 `hawkeye-print`
   - 路径：选择刚才上传了本压缩包文件的 `/docker/hawkeye` 文件夹（系统会自动识别里面的 `docker-compose.yml`）。
   - 勾选「创建项目后立即启动」，点击完成构建并启动！
3. 启动成功后，在浏览器访问：`http://您的飞牛或NAS局域网IP:19180`
   - 在网页上查看 **6 位配对码**，并在网页底部核对或手动输入家里打印机的局域网 IP（如 `192.168.1.150`）。
   - 打开手机【鹰眼打印 App】 -> 【☁️ 远程打印】 -> 【🌍 我在外地远程打印】 -> 输入该 6 位配对码即可随时异地打印！

------------------------------------------------------------------------
【方案 C：飞牛 fnOS / 威联通 / Linux 终端 SSH 一键脚本运行（免 Docker）】
------------------------------------------------------------------------
如果您的 NAS 开启了 SSH（飞牛 fnOS / 群晖 / 威联通均内置 Python3），也可解压后在终端执行：
  chmod +x start_nas_background.sh
  ./start_nas_background.sh
即可在后台常驻运行，并访问 `http://NAS的IP:19180` 进入可视化网页后台！
