百科.dev
全部条目在线工具AI 编程趋势榜开源项目技术资讯提交条目
登录
< 返回工具列表
R

rallyup

> 编程语言
开源

rallyup 是一款轻量级的 Wake-On-LAN (WOL) 计划程序和依赖管理器,专为小型企业和家庭实验室设计。

361 stars0 点赞1 次浏览
访问官网GitHub

工具介绍

rallyup 是一款轻量级的 Wake-On-LAN (WOL) 计划程序和依赖管理器,专为小型企业和家庭实验室设计。

rallyup

rallyup is a lightweight Wake-On-LAN (WOL) scheduler and dependency manager designed for small businesses and homelabs. It ensures that infrastructure services like firewalls, storage, and hypervisors are brought online in the correct order, particularly after events like power outages.

A typical setup involves configuring most of the infrastructure for WOL but not for Wake-On-Power, and setting rallyup to run on startup on a low-power device like a Raspberry Pi. When you need to bring the entire environment online, simply power on the device running rallyup, and the rest of the infrastructure will automatically follow in the correct order.

Features

  • VLAN Support: Send WOL packets to devices across different VLANs.
  • YAML Configuration: Easily define server boot sequences, dependencies, and status checks.
  • Service Status Checks: Verify that a service is up using built-in status checks (HTTP health checks, NFS, SMB, custom shell commands).
    • HTTP
    • Open port
    • Shell
    • NFS (might just use open port check)
    • SMB (might just use open port check)
  • Plugin-Friendly: Users can write their own custom status check plugins.

Usage

bash
rallyup servers.yaml

Configuration

The dependencies between servers, along with the methods for validating that they are online, are defined in a YAML configuration file.

Servers Configuration

Fields:

  • name: The name of the server, used for identification when defining dependencies between servers
  • mac: The MAC address of the server we want to wake up
  • interface: The network interface to use when sending the WOL packet
  • vlan: The VLAN ID (optional) that the server is on
  • depends: A list of other server names that this server depends on
  • check: A list of health checks that must pass before this server is considered fully online

Example:

yaml
- name: "firewall"
  mac: "00:11:22:33:44:55"
  interface: "eth0"
  vlan: 100
  depends:
    - "storage"
  check: [... see below]

Health Check Configurations

Each server can have multiple health checks to ensure the server is fully online before the next device starts up.

Common Fields

  • retry: The interval, defined in human readable string (e.g. 1s, 1 minute, etc.) to wait between retrying this health check
  • timeout: The timeout interval after which the check, and subsequently the entire boot sequence, will fail

Built-in Health Checks

HTTP Health Checks

The HTTP health check verifies whether a specified endpoint responds as expected.

Fields

  • type: should be http for an HTTP health check.
  • url: The URL to perform the HTTP health check against
  • status: Expected HTTP status code
  • regex: Regex to match in the response body

Note: You must provide either status or regex, or both.

Example

yaml
- type: http
  url: "http://192.168.1.1/health"
  status: 200
  retry: 5s
  timeout: 30s

Port Health Check

The port health check verifies whether a specified TCP port on a server is open and accessible. This is really a stand-in for verifying NFS and SMB ports until I can figure out how to check if those services are online.

Fields

  • type: should be port for a port health check
  • ip: the IP address to check
  • port: the port number to check

Example

yaml
- type: port
  ip: "192.168.1.1"
  port: 22
  retry: "10s"
  timeout: "1m"

Shell Health Checks

The shell health check executes a shell command checks the result. This is to provide the option of user-defined health checks.

Fields

  • type: should be shell for a shell health check.
  • command: he shell command to execute
  • status: Expected exit code
  • regex: Regex to match in the standard output

Note: You must provide either status or regex, or both.

Example

yaml
- type: shell
  command: ping -c 1 192.168.1.1
  status: 0
  retry: 5s
  timeout: 20s

Full Example

TODO:

  • Need to test in the lab and post the actual sample
…

License

This project is licensed under either of the following licenses, at your option:

  • MIT License
  • Apache License 2.0

You may choose to use this project under the terms of either license.

Issues· 0 开放

查看全部 Issues在 GitHub 打开

暂无开放 Issues,或尚未同步最近议题。

> 标签

Rustautomationcommand-linecommand-line-toolhomelab

暂无评论,来聊聊你的看法吧

> 工具信息

发布日期2026年8月1日
最后更新2026年9月17日
分类编程语言
定价开源

> 相关工具

T
TypeScript
JavaScript 的超集,为前端与全栈提供静态类型
P
Python
通用编程语言,广泛用于 Web、数据与 AI
G
Go
Google 推出的简洁高效系统语言