如何在macOS沙盒环境的Electron应用中嵌入本地服务器？

1. 避开特权端口限制 #

Mac沙盒禁止应用绑定1024以下的特权端口，这类端口需要系统级权限，沙盒应用无法获取。直接把你的PORT_NAME改成1024以上的端口，比如3000、8080这类常用非特权端口。

2. 补全沙盒权限配置 #

仅加网络权限不够，需要在entitlements.plist里补充本地网络访问权限，若服务器涉及文件读写还要加对应权限，完整配置示例：

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>com.apple.security.network.client</key>
    <true/>
    <key>com.apple.security.network.server</key>
    <true/>
    <!-- 允许本地回环网络通信，沙盒默认限制 -->
    <key>com.apple.security.network.local-address</key>
    <true/>
    <!-- 服务器读本地文件需加这个权限 -->
    <key>com.apple.security.files.user-selected.read-only</key>
    <true/>
    <!-- 有写入需求就放开下面这行 -->
    <!-- <key>com.apple.security.files.user-selected.read-write</key>
    <true/> -->
</dict>
</plist>

3. 明确绑定回环地址 #

沙盒环境下别用0.0.0.0绑定所有地址，直接指定127.0.0.1或localhost，修改监听代码：

// 替换原来的监听代码
server.listen(PORT_NAME, '127.0.0.1', () => {
  console.log(`Server running on http://127.0.0.1:${PORT_NAME}`);
});

4. 修正Electron打包配置 #

确保electron-builder的配置里正确关联权限文件，以package.json的build字段为例：

{
  "build": {
    "mac": {
      "entitlements": "entitlements.plist",
      "entitlementsInherit": "entitlements.plist",
      "hardenedRuntime": true,
      "target": "mas"
    }
  }
}

entitlementsInherit必须设置，否则渲染进程无法继承沙盒权限。

5. 用崩溃日志精准定位 #

打开Mac「控制台」应用，在「用户报告」里搜你的应用崩溃日志，日志会明确标出崩溃原因——比如权限不足、端口被占用、代码逻辑错误，这是最快找问题的方式。

内容的提问来源于stack exchange，提问作者Kim Mỹ