Macos on OHTLY Blog

macOS 终端 SSH 免密码：agent 配置实录

Fri, 24 Jul 2026 00:11:41 +0800

现象链接到标题

打开新的终端窗口，执行 ssh <内网服务器> 时反复提示：

Enter passphrase for key '~/.ssh/id_rsa':

明明之前在钥匙串中保存了密码，不该每次都输。

排查链接到标题

SSH_AUTH_SOCK 指向僵尸 socket 链接到标题

$ ssh-add -l
Error connecting to agent: Connection refused

$ echo $SSH_AUTH_SOCK
/var/folders/.../agent.45029   ← 指向一个已经死掉的 agent 进程

SSH_AUTH_SOCK 环境变量保存着一个已经不存在的 agent 进程的 socket 路径。

多个 ssh-agent 进程同时运行链接到标题

$ ps aux | grep ssh-agent
marshal  45030  ...  ssh-agent -s
marshal  45031  ...  ssh-agent -s
marshal  45312  ...  /usr/bin/ssh-agent -l

一个用户账号下同时跑了 3 个 ssh-agent，不正常。

Electron 项目 macOS 构建配置

Mon, 13 Jul 2026 10:46:12 +0800

背景链接到标题

Electron 是用 Web 技术构建跨平台桌面应用的主流方案。本文记录从零搭建 Electron 项目并通过 electron-builder 构建 macOS 安装包的过程。无需 Apple Developer 账号，构建出的 .dmg 可在本机安装运行。

项目结构链接到标题

electron-proto/
├── package.json
├── src/
│   ├── main.js          # 主进程
│   └── index.html       # 渲染页面
└── release/             # 构建产物

配置链接到标题

package.json 链接到标题

{
  "name": "electron-proto",
  "version": "1.0.0",
  "main": "src/main.js",
  "scripts": {
    "start": "electron .",
    "build:mac": "electron-builder --mac"
  },
  "devDependencies": {
    "electron": "^33.0.0",
    "electron-builder": "^25.1.0"
  },
  "build": {
    "appId": "com.electron.proto",
    "productName": "ElectronProto",
    "directories": {
      "output": "release"
    },
    "mac": {
      "category": "public.app-category.utilities",
      "target": ["dmg"],
      "identity": null
    }
  }
}

identity: null 是关键——告诉 electron-builder 跳过代码签名，否则没有开发者证书时会构建失败。

macOS 下 Markdown 数学公式正确转 PDF

Wed, 08 Jul 2026 18:48:00 +0800

问题链接到标题

Markdown 里用 $$ 写好的 LaTeX 数学公式：

$$
\nabla \cdot \mathbf{E} = \frac{\rho}{\varepsilon_0}
$$

期望渲染效果：

$$ \nabla \cdot \mathbf{E} = \frac{\rho}{\varepsilon_0} $$

但转 PDF 时，要么公式显示为原始代码，要么中文字体缺失乱码。本文记录 macOS 下的可行方案。

方案一：Pandoc + XeLaTeX（不推荐）链接到标题

brew install basictex
pandoc file.md -o file.pdf --pdf-engine=xelatex -V mainfont='PingFang SC'

公式渲染效果没问题，但输出风格偏 TeX 传统——标题字体、表格样式、公式间距都与现代文档有明显差异，不够美观。

推荐方案：Pandoc + MathJax + Puppeteer 链接到标题

核心思路：用 Pandoc 生成带 MathJax CDN 的 HTML，再用 Puppeteer（Headless Chrome）渲染出 PDF。输出样式完全由 CSS 控制。

NetBird 子网路由与 Access Policy 配置

Tue, 23 Jun 2026 18:25:39 +0800

场景链接到标题

办公室有大量 VM（host-a、host-b、host-c 等），它们无法或不适合安装 NetBird agent。家里的笔记本需要能直接通过这些机器的 LAN IP 访问（RustDesk、SSH 等），而不能逐个安装 agent。

方案：路由 peer 链接到标题

NetBird 的 Network Route 功能允许将整个子网通过一个路由 peer 暴露给 VPN 网络。

家里笔记本 ── NetBird 隧道 ── gateway(路由 peer) ── 办公室 LAN 192.168.0.0/24
                                                    ├── host-a      (192.168.0.*)
                                                    ├── host-c      (192.168.0.*)
                                                    └── 其他无 agent 节点

路由 peer（gateway）对流量做 Masquerade（NAT），将来自 NetBird 的包源 IP 替换为自己的 LAN IP，这样目标机器的回包就能正确路由回来。

前置条件链接到标题

路由 peer 需要开启 IP 转发：

echo "net.ipv4.ip_forward=1" | sudo tee /etc/sysctl.d/99-netbird-forward.conf
sudo sysctl -p /etc/sysctl.d/99-netbird-forward.conf

第一步：创建 Network Route 链接到标题

source .env

curl -X POST "https://your-management/api/routes" \
  -H "Authorization: Token $NETBIRD_PAT" \
  -H "Content-Type: application/json" \
  -d '{
    "description": "Office LAN",
    "network_id": "office-lan",
    "enabled": true,
    "peer": "<gateway_peer_id>",
    "network": "192.168.0.0/24",
    "metric": 100,
    "masquerade": true,
    "groups": ["<all_group_id>"]
  }'

关键参数：

Obsidian vault 放 iCloud 目录影响 AI 操作笔记

Thu, 18 Jun 2026 11:39:37 +0800

问题链接到标题

Obsidian vault 放在 ~/Documents/ 目录下。AI 助手（OpenClaw）通过 shell/Obsidian CLI 操作笔记时，cp、mv、rm 随机报 Operation not permitted。

具体症状：

0 字节的「幽灵文件」创建后删不掉、读不了
xattr、lsof 都拒绝访问
但 Obsidian 应用本身读写正常

原因链接到标题

~/Documents/ 是 macOS iCloud Drive 的默认托管目录。即使没有登录 iCloud 账号，该目录下的文件也受系统级隐匿保护（stub file、ACL 锁）。这种保护只拦截非 GUI 的文件操作——shell 脚本、AI 工具写文件都会中招，但 Obsidian 应用不受影响。

vault 挪到 ~/workspace/ 后所有问题消失。

解决链接到标题

# 关 Obsidian
# 完整复制 vault
cp -a ~/Documents/jax-notes ~/workspace/jax-notes
# Obsidian 重新打开新位置，确认 LiveSync 同步正常
# 删旧的
rm -rf ~/Documents/jax-notes

LiveSync（CouchDB 同步）配置在 .obsidian/plugins/ 目录，随 vault 一起搬走，不受影响。

macOS 下用函数快速启动 VS Code SSH Remote

Sun, 14 Jun 2026 19:59:37 +0800

背景链接到标题

日常开发免不了频繁通过 VS Code 的 Remote SSH 连接远程服务器。每次都要敲：

code --remote ssh-remote+some-host /home/user/project

路径要记、主机名要打、目录要拼，烦。

能不能 rcode my-server 就完事？

其他方案对比链接到标题

先看看除了敲命令，还有哪些方式打开 Remote SSH：

方案	操作步骤	评价
VS Code 命令面板	`F1` → “Remote-SSH: Connect to Host…” → 选主机 → `File > Open Folder` → 选目录	点选四五次，慢
本地终端 `code --remote`	`code --remote ssh-remote+some-host /home/user/project`	可用，但路径要自己记
macOS `open` 打开 URL	`open vscode://vscode-remote/ssh-remote+some-host/home/user/project`	可脚本化，但路径写死
Markdown/HTML 中放 VS Code 链接	在文档里写 `vscode://vscode-remote/ssh-remote+some-host/home/user/project`，浏览器点击触发	适合文档入口，但仍然路径写死
终端别名/函数	本文方案	一行搞定

这里容易踩一个坑：code 是本地 macOS 上的 VS Code CLI，不是远程服务器上的命令。已经 SSH 登录到远程机器后再敲 code .，通常只会得到 command not found。

Macos on OHTLY Blog

macOS 终端 SSH 免密码：agent 配置实录

现象 链接到标题

排查 链接到标题

SSH_AUTH_SOCK 指向僵尸 socket 链接到标题

多个 ssh-agent 进程同时运行 链接到标题

Electron 项目 macOS 构建配置

背景 链接到标题

项目结构 链接到标题

配置 链接到标题

package.json 链接到标题

macOS 下 Markdown 数学公式正确转 PDF

问题 链接到标题

方案一：Pandoc + XeLaTeX（不推荐） 链接到标题

推荐方案：Pandoc + MathJax + Puppeteer 链接到标题

NetBird 子网路由与 Access Policy 配置

场景 链接到标题

方案：路由 peer 链接到标题

前置条件 链接到标题

第一步：创建 Network Route 链接到标题

Obsidian vault 放 iCloud 目录影响 AI 操作笔记

问题 链接到标题

原因 链接到标题

解决 链接到标题

macOS 下用函数快速启动 VS Code SSH Remote

背景 链接到标题

其他方案对比 链接到标题

现象链接到标题

排查链接到标题

多个 ssh-agent 进程同时运行链接到标题

背景链接到标题

项目结构链接到标题

配置链接到标题

问题链接到标题

方案一：Pandoc + XeLaTeX（不推荐）链接到标题

场景链接到标题

前置条件链接到标题

问题链接到标题

原因链接到标题

解决链接到标题

背景链接到标题

其他方案对比链接到标题