turnintoserver

KO | EN

gitlite — search

#opensource #ai #python #bocaletto-luca #golang #chatbot #javascript #macos #linux #react #llm #docker

★ 103 Open GitHub ↗

Use a MacBook as a closed-lid server while setting the built-in display to zero brightness.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# turnintoserver

[English](README.en.md) · [产品页面](https://qianyushi.github.io/turnintoserver/)

合上盖子。  
Mac 继续工作。  
内建屏不再发光。

`turnintoserver` 是一个 macOS 菜单栏小工具。

给 MacBook 接上电源，打开 Server Mode，合盖后它还能继续跑 SSH、远程桌面、开发服务器和局域网服务。同时，它会尽量只把 MacBook 自己的内建屏幕亮度降到 0，避免那块看不见的屏幕继续发光。

我写它，是因为我想把 MacBook 临时当一台小服务器用。但普通防睡眠工具通常只管“不睡”，不太管合盖后屏幕还亮不亮。

## 主要功能

- 合盖后保持 Mac 运行。
- 合盖时把内建屏幕亮度降到 0。
- 不主动关闭外接显示器。
- 接电源时运行，切到电池后自动暂停。
- 接回电源后自动恢复。
- 支持在指定时长内启动 Server Mode，到点后自动恢复 macOS 原本的电源管理。
- 可以手动允许电池模式。
- 电池模式下可通过 iMessage 或 Bark 提醒电量不足。
- 支持自定义全局快捷键。
- 支持开机自动启动。
- 可独立开启双接入点自动路由分流；两个接入点、识别特征和内网 CIDR 都可在菜单右侧“设置”中维护，首次安装仅提供少量通用示例。
- 可在 Server Mode 开启时自动静音，关闭后恢复原来的静音状态。

## 适合这些情况

- 合盖后继续 SSH 到这台 Mac。
- 在局域网里跑开发服务器。
- 用远程桌面连接 MacBook。
- 让同步、下载、媒体服务继续跑。
- 临时把 MacBook 放桌面上当小服务器。

## 安装

下载最新版：

https://github.com/QianYushi/turnintoserver/releases/latest

然后：

1. 打开 `turnintoserver.dmg`。
2. 把 `turnintoserver.app` 拖到“应用程序”。
3. 启动 `turnintoserver`。
4. 在菜单栏里打开 Server Mode。

第一次开启时，macOS 可能会要求输入管理员密码。这是为了允许系统在合盖后继续运行。

## 使用

打开后，app 只会出现在菜单栏。

常用的就这几个：

- `启动 Server 模式`：开启后，接电源时合盖也会继续运行。
- `在一段时间内启动`：可选择 30 分钟、1 小时、2 小时等时长；到点后自动关闭 Server Mode。再次点击当前时长会清除计时，点击其他时长会重新计时。
- `电池也允许 Server 模式`：断电后也继续运行。默认关闭。
- `推送低电量通知`：电池模式运行时，低于 50% 和 20% 会通过已配置通道提醒，右侧“设置”可配置 iMessage / Bark。
- `启用快捷键`：开启或关闭全局快捷键，右侧“设置”可录制两个快捷键。
- `开机自动启动`：登录后自动打开 app。
- `打开自动路由表`：独立监听两个可维护的 macOS 网络服务；两者同时被 App 检测为在线时，当前内网 CIDR 列表走第一个“内网路由出口”，其他流量仍使用 macOS 默认出口。它不受 Server Mode 开关控制。右侧“设置”可选择两个网络服务，并为每端填写可选的 `ipconfig` 摘要识别特征（如 DNS 或 IP）；留空则只判断链路在线。同一窗口也可按一行一条维护 IPv4 CIDR，支持 `/8`、`/16`、`/24`、`/32`。首次安装仅显示 Wi-Fi、Ethernet 和 3 条通用 CIDR 示例；覆盖安装会继续读取同一 Bundle ID 下已经保存的接入点、识别特征和 CIDR，不会用示例覆盖历史输入。保存后会清理旧出口上的 App 托管路由，并按新配置重新对齐；鼠标悬停会显示 App 实时检测到的实际接入点名称、状态、当前路由覆盖数和默认出口。
- `开启时静音`：Server Mode 实际开启时静音；关闭 Server Mode 或取消该选项时恢复开启前的静音状态。
- `关于应用`：查看版本、开发者、GitHub 地址并检查更新。
- `退出`：退出前恢复系统默认睡眠行为。

一般情况下，打开 Server Mode，然后合盖就可以了。

如果只想临时运行一段时间，可以在菜单里选择“在一段时间内启动”。定时结束后，app 会关闭 Server Mode，并恢复 macOS 原本的睡眠和电源管理行为。普通启动不选时长时仍是无限期运行。

如果没有打开电池模式，拔掉电源后它会暂停；再次接上电源后会自动恢复。

低电量提醒需要先在菜单中点击“推送低电量通知”右侧的“设置”，配置 iMessage 或 Bark，并测试成功后才能开启。只填写一个通道就只推送一个；两个都填写时会同时推送。iMessage 首次发送时，macOS 会询问是否允许 `turnintoserver` 控制 Messages，请选择允许。Bark 支持填写类似 `https://api.day.app/你的key` 的推送地址。

检查更新会直接下载新版 DMG，显示下载进度，准备好后可以点击“重新启动应用”完成替换安装。

## 关于屏幕

`turnintoserver` 不只是让 Mac 不睡。

它更在意合盖后的那块内建屏幕。合盖时，它会尽量只把 MacBook 自己的屏幕亮度降到 0，而不是把所有显示器都关掉。这样外接显示器不会被它主动熄灭，合盖里面那块屏幕也不再发光。

## 注意

不要把合盖运行中的 MacBook 放进包里、抽屉里，或者其他不通风的位置。

它适合接电源、放桌面、有正常散热空间的使用方式。内建屏亮度降到 0 后，可以减少那块屏幕的发光、发热和亮屏损耗，但不能替代散热。

## 系统要求

- Intel Mac：macOS 10.15 Catalina 或更高版本。
- Apple Silicon Mac：macOS 11 Big Sur 或更高版本。
- 推荐接电源使用。

## 说明

`turnintoserver` 不是 Mac App Store 应用，也没有启用 App Sandbox。

turnintoserver

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README