DontCrack4Mac

macOS 进程管理器

一、功能简介

• macOS 平台下的进程管理器，用于提高后台/守护进程的健壮性、可用性、时序稳定性
• 通过 launchd (LaunchAgent/LaunchDaemon) 或命令行直接托管一个目标进程，避免应用自身崩溃导致服务不可用
• 支持管理这些类型的进程：二进制可执行程序（Mach-O / universal binary）、shell脚本
• 实现将进程对应到端口号，可通过 Restful API 实现获取日志、开关进程等操作
• 启动的进程可以配置独立的：程序路径、环境变量、启动参数、预处理脚本、是否自动重启、崩溃自动重启次数、是否立即启动、端口号、日志最大缓存行数、单行日志最大字节数、日志本地存储路径、日志本地存储周期等
• 支持跨架构，免 CGO，支持 macOS amd64 / arm64 (Apple Silicon)
• 与 Linux (manylinux)、Windows、OpenHarmony、Android 版本共享同一套命令、HTTP 接口、文件结构

二、基础用法

./dontcrack-mac \
  -path "/opt/DontCrack4Mac/example/childproc/childproc" \
  -args "-mode normal -interval 500ms -lifetime 5s" \
  -env "EXTRA_INFO=from_manager RESTART_ENV_COUNT=0" \
  -file-log -log-path ./example/logs/ -log-life-day 7 \
  -auto-restart -max-retries 2 \
  -start-now \
  -password 123456

配置项	类型	默认值	说明
path	string	""	要管理的程序路径（支持可执行文件、shell脚本等）
args	string	""	传递给程序的参数（可选）
pre	string	""	启动前要执行的命令（在 sh 中执行，可用&&/;/
env	string	""	为子进程追加环境变量，如: "PATH=/usr/local/bin:/usr/bin FOO=bar"；用空格或分号分隔
auto-restart	bool	false	是否自动重启
max-retries	int	3	最大重试次数（-1表示无限次，默认3次）
start-now	bool	false	是否立即启动
password	string	""	管理进程的密码（可选，默认为空且不开启密码保护）
port	int	11883	HTTP服务端口
log-capacity	int	200	日志缓存的最大行数（默认200）
log-max-line-bytes	int	1048576	单行日志的最大字节数（用于bufio.Scanner，默认1MiB）
file-log	bool	false	是否启用文件日志（默认false）
log-path	string	./logs/proc_manager/	本地日志文件目录（默认 ./logs/proc_manager/，按进程名创建子目录）
log-life-day	int	7	本地日志文件保存天数（默认7天，新日志写入时会清理过期文件）

三、接口文档

/startup

• 接口说明：启动进程，同时会重置重启次数
• 请求方式：get、post
• 请求参数

  password: 密钥（可选params参数）
  

• 返回类型：文本
• 返回示例：

  ok
  

/heartbeat

• 接口说明：获得心跳信息，会输出启动情况和缓存中的日志（同时会清除缓存）
• 请求方式：get、post
• 请求参数

  password: 密钥（可选params参数）
  

• 返回类型：JSON
• 返回示例：

  {
  "version": "1.0.20260922",
  "state": "stopped",
  "info": "进程管理器正常运行",
  "timestamp": "2026-08-25 15:28:04",
  "logs": [
  "[STDERR] 2026/08/25 15:27:55.647714 env restart count -> 1",
  "[STDERR] 2026/08/25 15:27:55.648316 childproc start | pid=32054 | mode=normal | interval=1s | lifetime=5s | msg=",
  "[STDERR] 2026/08/25 15:27:55.648345 args: /opt/.../childproc -mode normal -interval 1s -lifetime 5s",
  "[STDERR] 2026/08/25 15:27:55.648352 env EXTRA_INFO=from_manager",
  "[STDERR] 2026/08/25 15:27:55.648353 env RESTART_ENV_COUNT=0",
  "[STDERR] 2026/08/25 15:27:56.668982 tick at 2026-08-25T15:27:56.64879725+08:00",
  "[STDERR] 2026/08/25 15:28:00.686300 lifetime reached, exiting normally"
  ],
  "process_pid": 0,
  "process_path": "/opt/.../childproc",
  "restart_count": 0,
  "file_type": "binary_executable",
  "last_exit_time": "2026-08-25 15:28:00",
  "program_args": "-mode normal -interval 1s -lifetime 5s",
  "extra_env_raw": "PATH=/usr/local/bin EXTRA_INFO=from_manager RESTART_ENV_COUNT=0"
  }
  

/shutdown

• 接口说明：终止进程
• 请求方式：get、post
• 请求参数

  password: 密钥（可选params参数）
  

• 返回类型：文本
• 返回示例：

  ok
  

四、细节说明

• 目标管理的进程的 Path 尽量使用全路径
• macOS 默认 shell 为 /bin/sh，本版直接使用，与 Linux 版保持一致
• 运行的文件使用 .sh 结尾、首行包含 #! 都将被识别为脚本文件，由 /bin/sh 执行
• 二进制可执行文件通过 Mach-O / universal binary 魔数识别（支持 Apple Silicon 与 Intel）
• 开启密码时，接口请求需要在 URL 参数中携带 password 参数，例如 xxx/startup?password=123456
• 与 OpenHarmony / Android 版的差异:
  • 启动横幅、根路径消息改为 DontCrack_mac
  • 通过 Mach-O / universal binary 魔数识别 macOS 可执行文件
  • 使用 /bin/sh 执行 shell 脚本与前命令（与 Linux 版一致）
  • 示例改为 launchd agent (example/com.fasteredge.dontcrack.plist)

五、macOS launchd 集成

将编译好的 dontcrack-mac 放到 /usr/local/bin/，然后安装 LaunchAgent：

sudo ./example/install_launchd.sh
launchctl list | grep dontcrack
tail -f /var/log/dontcrack/manager.stdout.log

完整示例见 example/com.fasteredge.dontcrack.plist，记得按实际情况调整 ProgramArguments 中的托管进程路径、端口、预处理脚本等参数。

六、使用技巧

• 单独使用时如果在会话中使用 & 作为命令结尾时一般会话结束的时候这个操作也会被杀死
• Go 语言程序的 log.Printf 默认将数据写到 os.Stderr，所以子进程中日志类型会显示为 [STDERR]，可以换成 fmt.Println 得到非 [STDERR] 的消息
• 因为可以通过 HTTP 带加密的形式操作进程，你可以根据此文档将进程操作结合系统角色，再结合 AI + MCP（或 Skills）完成各种操作
• 除了可以使用直接功能保证进程健壮性，还可以利用反复重启机制实现进程轮询，预先脚本也能实现延迟启动、等待依赖进程等操作