Oh My Pi：将任何树莓派变成智能设备——12K 星项目 2026

# 在全新的 Raspberry Pi OS 上安装 Oh My Pi
curl -sSL https://ohmypi.sh/install | sudo bash

# 或克隆后手动运行
git clone https://github.com/can1357/oh-my-pi.git
cd oh-my-pi
sudo ./install.sh

# 第一阶段：系统配置
sudo omp provision --hostname mypi --ssh-key ~/.ssh/id_ed25519.pub

# 第二阶段：安装服务
sudo omp install homeassistant grafana vaultwarden

# 第三阶段：生成仪表板
sudo omp dashboard --title "我的智能 Pi" --theme dark

# 第一步：刷入 Raspberry Pi OS Lite
# 从 https://www.raspberrypi.com/software/ 下载

# 第二步：启用 SSH 和 WiFi
# 在 boot 分区添加 ssh 文件和 wpa_supplicant.conf

# 第三步：启动 Pi 并查找其 IP
# 使用以下命令扫描你的网络：nmap -sn 192.168.1.0/24

# 第四步：SSH 登录并安装 Oh My Pi
ssh pi@<pi-ip>
curl -sSL https://ohmypi.sh/install | sudo bash

# 安装服务后生成的 docker-compose.yaml
version: "3.9"
services:
  homeassistant:
    image: ghcr.io/home-assistant/home-assistant:stable
    volumes:
      - ha-data:/config
      - /etc/localtime:/etc/localtime:ro
    ports:
      - "8123:8123"
    restart: unless-stopped

  adguard:
    image: adguard/adguardhome:latest
    volumes:
      - adguard-conf:/opt/adguardhome/conf
      - adguard-work:/opt/adguardhome/work
    ports:
      - "53:53/tcp"
      - "53:53/udp"
      - "3000:3000"
      - "80:80/tcp"
    restart: unless-stopped

  vaultwarden:
    image: vaultwarden/server:latest
    volumes:
      - vw-data:/data
    environment:
      SIGNUPS_ALLOWED: "false"
    restart: unless-stopped

volumes:
  ha-data:
  adguard-conf:
  adguard-work:
  vw-data:

# 配置静态 IP
sudo omp network static --ip 192.168.1.100 --gateway 192.168.1.1 --dns 8.8.8.8

# 设置 DNS 转发
sudo omp network dns --upstream 1.1.1.1 --local 127.0.0.1

# 配置防火墙
sudo omp firewall enable --allow 22 --allow 80 --allow 443 --allow 8123

# 安装完整的智能家居设置
sudo omp install homeassistant zigbee2mqtt adguard grafana vaultwarden

# 所有服务按协调顺序部署
# Home Assistant 首先启动，然后 Zigbee2MQTT 连接，
# AdGuard 处理 DNS，Grafana 监控一切

# my-service.yaml — 自定义服务定义
service:
  name: my-custom-app
  version: "1.0"
  description: "自定义应用程序部署"
  
  docker:
    image: "myapp:latest"
    ports:
      - "8080:8080"
    volumes:
      - myapp-data:/data
    environment:
      APP_ENV: production
      LOG_LEVEL: info
  
  health_check:
    url: "http://localhost:8080/health"
    interval: "30s"
    retries: 3
  
  resources:
    cpu_limit: "0.5"
    memory_limit: "256M"
  
  backup:
    enabled: true
    schedule: "0 2 * * *"  # 每天凌晨 2 点
    volumes:
      - myapp-data

# 配置备份目标
sudo omp backup configure --remote s3 --bucket ohmypi-backups --region us-east-1

# 立即运行备份
sudo omp backup run

# 从备份恢复
sudo omp backup restore --date 2026-06-14 --verify

# 设置每日计划备份
sudo omp backup schedule --frequency daily --retention 30

# 设置 Cloudflare 隧道（免费，无需端口转发）
sudo omp tunnel cloudflare --token <cloudflare-token>

# 或使用 ngrok 快速访问
sudo omp tunnel ngrok --authtoken <ngrok-token>

# 使用 Caddy 配置反向代理（自动 HTTPS）
sudo omp proxy caddy --domain mypi.local --ssl auto

# 将第二台 Pi 添加到集群
sudo omp cluster add --host pi2.local --user pi --key ~/.ssh/id_ed25519

# 跨所有节点部署服务
sudo omp cluster deploy --services homeassistant,grafana --nodes all

# 查看集群健康状态
sudo omp cluster health

# 检查 SD 卡健康状况
sudo omp storage health

# 启用预测性故障警报
sudo omp storage alerts --enable --threshold 70

# 设置自动健康检查
sudo omp storage schedule --interval hourly

# 配置 UPS 监控
sudo omp ups configure --driver usb --shutdown-delay 300

# 设置优雅关机的电池阈值
sudo omp ups threshold --battery 20 --action shutdown

# 监控电源事件
sudo omp ups logs --tail 50

# 设置资源阈值
sudo omp monitor thresholds --cpu 90 --memory 85 --disk 80

# 配置告警通知
sudo omp monitor alerts --channel telegram --token <bot-token> --chat <chat-id>

# 查看资源历史记录
sudo omp monitor history --period 7d --graph

# 快速适用性检查
# ✅ 智能家居中枢 → 适合
# ✅ 媒体服务器 → 适合
# ✅ 开发工作站 → 适合
# ✅ 生产数据库服务器 → 不适合（使用专用硬件）
# ✅ IoT 传感器项目 → 不适合（仅关注网络服务）

curl -sSL https://ohmypi.sh/install | sudo bash