局域网唤醒工具UpSnap

news2024/12/24 21:21:39

在这里插入图片描述

什么是 UpSnap ？

UpSnap 是使用 SvelteKit、Go、PocketBase 和 nmap 编写的简单局域网唤醒应用程序。

v3 更新日志：

⚙️ 后端：
- 用 Go 重写。之前的版本是 Python 写的；
- 不再支持不同的数据库。后端现在使用基于 SQLite 的 PocketBase；
- 添加了使用密码唤醒事件的选项。如果您的网卡支持，您可以在 BIOS中找到它，称为 SecureOn 或 smiliar；
- PocketBase 提供了一个 API。可以登录 localhost:8090/_/，点击右上角的 API reviewP·
🎨 前端：
- 从 Svelte 转换为 SvelteKit，并且几乎重写了所有内容；
- 摆脱了模式。页面应该更加用户友好；
- 设备卡上更好的徽章以显示 cron 事件和密码保护;
通用：
- 大大减少资源需求；
- 单个二进制文件即可运行所有内容
- 反向代理不再需要自定义路由；

安装

在群晖上以 Docker 方式安装。

镜像下载

官方的镜像发布在 ghcr.io，
地址：https://github.com/seriousm4x/UpSnap/pkgs/container/upsnap

用 SSH 客户端登录到群晖后，依次执行下面的命令

# 新建文件夹 upsnap 和子目录 
mkdir -p /volume2/docker/upsnap/data

# 进入 upsnap 目录
cd /volume2/docker/upsnap

# 拉取镜像
## 需要注意：官方没有 latest ，所以需要自己去查最新的版本
docker pull ghcr.io/seriousm4x/upsnap:3.0.3

如果没有科学上网，很可能会拉不动，可以试试 docker 代理网站：https://dockerproxy.com/，但是会多几个步骤

# 如果拉不动的话加个代理
docker pull ghcr.dockerproxy.com/seriousm4x/upsnap:3.0.3

# 重命名镜像（如果是通过代理下载的）
docker tag ghcr.dockerproxy.com/seriousm4x/upsnap:3.0.3 ghcr.io/seriousm4x/upsnap:3.0.3

# 删除代理镜像（如果是通过代理下载的）
docker rmi ghcr.dockerproxy.com/seriousm4x/upsnap:3.0.3

下载完成后，可以在 映像 中找到

在这里插入图片描述

命令行安装

如果你熟悉命令行，可能用 docker cli 更快捷

# 新建文件夹 upsnap 和 子目录
mkdir -p /volume2/docker/upsnap/data

# 进入 upsnap 目录
cd /volume2/docker/upsnap

# 运行容器
docker run -d \
   --restart unless-stopped \
   --network host \
   --name upsnap \
   -v $(pwd)/data:/app/pb_data \
   ghcr.io/seriousm4x/upsnap:3.0.3

也可以用 docker-compose 安装，将下面的内容保存为 docker-compose.yml 文件

这是完整的官方版本

version: "3"

services:
  upsnap:
    image: ghcr.io/seriousm4x/upsnap:3.0.3
    container_name: upsnap
    network_mode: host
    restart: unless-stopped
    volumes:
      - ./data:/app/pb_data
    healthcheck:
      test: wget --no-verbose --tries=1 --spider http://localhost:8090/api/health || exit 1
      interval: 1m
      timeout: 10s
      retries: 3
    # environment:
    #   - TZ=Europe/Berlin # Set container timezone for cron schedules
    #   - UPSNAP_INTERVAL=@every 10s # Sets the interval in which the devices are pinged
    #   - UPSNAP_SCAN_RANGE=192.168.1.0/24 # Scan range is used for device discovery on local network
    #   - UPSNAP_WEBSITE_TITLE=Custom name # Custom website title
    # command: ["./upsnap", "serve", "--http", "0.0.0.0:8090"] # Uncomment this if you want to change the port for example

然后执行下面的命令

# 新建文件夹 upsnap 和 子目录
mkdir -p /volume2/docker/upsnap/data

# 进入 upsnap 目录
cd /volume2/docker/upsnap

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d