lnctl 安装指南（生产环境）

1. 默认安装命令

1.1 Linux/macOS/WSL

1.2 Windows PowerShell

irm https://s3-download.lightnode.com/lnctl/install.ps1 | iex

2. 安装完成后的提示命令

安装脚本输出 ✅ Installation complete! 即视为安装成功。

下面这些提示命令只对应默认安装目录。

如果脚本额外输出 Setup notes，说明当前 PATH 里还没有默认安装目录，可按平台执行下面的提示命令。

2.1 Linux/macOS/WSL

默认安装目录下，可按当前 shell 执行对应命令：

zsh:

bash:

其他 shell:

2.2 Windows PowerShell

默认安装目录下，可执行下面这组命令：

$dir = "$HOME\.lnctl\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
if ([string]::IsNullOrEmpty($userPath)) {
  [Environment]::SetEnvironmentVariable("Path", $dir, "User")
} elseif (($userPath -split ';' ) -notcontains $dir) {
  [Environment]::SetEnvironmentVariable("Path", "$userPath;$dir", "User")
}
$env:Path = [Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [Environment]::GetEnvironmentVariable("Path", "User")

3. 已安装后升级

生产环境构建安装完成后，可直接执行：

说明：

升级会继续使用 prod 下载源 https://s3-download.lightnode.com

lnctl upgrade 不需要 LightNode API key

Windows 升级时会在当前终端启动 helper cmd 进程完成最终替换，请保持当前终端打开直到最终成功/失败结果输出。若需再次确认版本，可额外执行 lnctl --version

4. Windows 故障排查

如果安装或升级失败后提示 lnctl.exe 被占用，可先在 PowerShell 中查询是否有残留 lnctl 进程：

Get-Process lnctl -ErrorAction SilentlyContinue

如果查到了残留进程，可执行：

Get-Process lnctl -ErrorAction SilentlyContinue | Stop-Process -Force

清理后重新执行安装或升级命令。

5. macOS Gatekeeper 说明

浏览器下载、Finder 解压的文件可能带 com.apple.quarantine，可能触发 Gatekeeper。

curl 下载 + 命令行解压（tar / unzip）通常不会带或传播该标记。

本项目当前推荐安装方式已使用 curl，暂按“不易触发该问题”处理。

若仍出现提示，可执行：

lnctl 安装指南（生产环境）

1. 默认安装命令#

1.1 Linux/macOS/WSL#

1.2 Windows PowerShell#

2. 安装完成后的提示命令#

2.1 Linux/macOS/WSL#

2.2 Windows PowerShell#

3. 已安装后升级#

4. Windows 故障排查#

5. macOS Gatekeeper 说明#