========================================================================
🦅 HawkEye Print (鹰眼打印) · NAS & Docker 24/7 Remote Print Gateway
Global Official Website: https://hawkeyecopy.com
Supported Systems: Synology DSM, QNAP, TrueNAS, Unraid, FnOS (飞牛), CasaOS, Linux Docker
========================================================================

[1. Overview]
Deploy this ultra-lightweight gateway (<10 MB RAM) on your home or office NAS / Docker server for 24/7 unattended remote printing!
Even if your network printer (Brother, HP, Canon, Epson, Ricoh, etc.) has no native cloud print support, HawkEye Print relays PC-Grade 600 / 1200 DPI 1-Bit print jobs from your phone anywhere in the world directly to your local printer.
* Running this NAS Gateway is 100% FREE forever (unlimited time & pages).

------------------------------------------------------------------------
[Method A: Synology DSM 10-Second Deployment (No Docker Needed!)]
------------------------------------------------------------------------
Synology DSM 7.x includes Python 3 natively. You can run it directly via Task Scheduler:
1. Extract this ZIP and upload the files (`lasersharp_gateway.py` and `start_nas_background.sh`) to a shared folder on your Synology NAS, e.g.:
   `/volume1/docker/hawkeye/`
2. Open Synology [Control Panel] -> [Task Scheduler].
3. Click [Create] -> [Triggered Task] -> [User-defined script]:
   - General: Task name = `hawkeye_gateway`, User = `root`, Event = `Boot-up`.
   - Task Settings (Run command):
     `nohup python3 /volume1/docker/hawkeye/lasersharp_gateway.py --headless --web-port 19180 >/dev/null 2>&1 &`
4. Click OK, select the `hawkeye_gateway` task, and click [Run] at the top!
5. Open `http://YOUR_NAS_IP:19180` in your browser to see your 6-digit Pairing Code & QR Code, and verify or set your printer's LAN IP.

------------------------------------------------------------------------
[Method B: Docker Compose Deployment (Synology Container Manager / QNAP / Unraid / FnOS / Linux)]
------------------------------------------------------------------------
1. Extract all files (`docker-compose.yml`, `Dockerfile`, `lasersharp_gateway.py`) into a folder on your NAS (e.g. `/docker/hawkeye`).
2. In your NAS Docker / Container Manager app -> [Compose / Projects] -> [Create] -> select the `/docker/hawkeye` folder and start the project (or run `docker compose up -d` via SSH).
3. Open `http://YOUR_NAS_IP:19180` in your browser to view the 6-digit Pairing Code and configure your printer IP.

------------------------------------------------------------------------
[Method C: Linux / NAS SSH One-Line Background Script (No Docker)]
------------------------------------------------------------------------
1. Extract the ZIP and run in SSH terminal:
   `chmod +x start_nas_background.sh && ./start_nas_background.sh`
2. Open `http://YOUR_NAS_IP:19180` in your browser.

========================================================================
【中文说明 · 群晖 Synology / 飞牛 fnOS / 威联通 / 绿联 NAS 远程打印网关部署说明】
官方网站：https://hawkeyecopy.com
========================================================================
- 方案 A（群晖免 Docker 10秒部署）：解压上传至 `/volume1/docker/hawkeye/`，在群晖【控制面板】->【任务计划】新增 root 开机脚本：
  `nohup python3 /volume1/docker/hawkeye/lasersharp_gateway.py --headless --web-port 19180 >/dev/null 2>&1 &`
  保存并点击【运行】，浏览器访问 `http://您的NAS局域网IP:19180` 即可获取 6 位配对码！
- 方案 B（飞牛 fnOS / Docker Compose）：将本包解压上传至 `/docker/hawkeye`，在 Docker -> Compose 中新增项目选择该目录一键启动，访问 `http://您的NAS局域网IP:19180` 即可。
