# lnctl 安装指南

# lnctl 安装指南

## 1. 默认安装命令

### 1.1 Linux/macOS/WSL

```bash
curl -fsSL "https://s3-download.lightnode.com/lnctl/install.sh" | bash
```

### 1.2 Windows PowerShell

```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
grep -qxF 'export PATH="$HOME/.lnctl/bin:$PATH"' ~/.zshrc 2>/dev/null || echo 'export PATH="$HOME/.lnctl/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
```

bash:

```bash
grep -qxF 'export PATH="$HOME/.lnctl/bin:$PATH"' ~/.bashrc 2>/dev/null || echo 'export PATH="$HOME/.lnctl/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
```

其他 shell:

```bash
grep -qxF 'export PATH="$HOME/.lnctl/bin:$PATH"' ~/.profile 2>/dev/null || echo 'export PATH="$HOME/.lnctl/bin:$PATH"' >> ~/.profile
source ~/.profile
```

### 2.2 Windows PowerShell

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

```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. 已安装后升级

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

```bash
lnctl upgrade
lnctl upgrade --force --yes
```

说明：

- 升级会继续使用 prod 下载源 `https://s3-download.lightnode.com`
- `lnctl upgrade` 不需要 LightNode API key
- Windows 升级时会在当前终端启动 helper `cmd` 进程完成最终替换，请保持当前终端打开直到最终成功/失败结果输出。若需再次确认版本，可额外执行 `lnctl --version`

## 4. Windows 故障排查

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

```powershell
Get-Process lnctl -ErrorAction SilentlyContinue
```

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

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

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

## 5. macOS Gatekeeper 说明

- 浏览器下载、Finder 解压的文件可能带 `com.apple.quarantine`，可能触发 Gatekeeper。
- `curl` 下载 + 命令行解压（`tar` / `unzip`）通常不会带或传播该标记。
- 本项目当前推荐安装方式已使用 `curl`，暂按“不易触发该问题”处理。

若仍出现提示，可执行：

```bash
xattr -dr com.apple.quarantine "$HOME/.lnctl/bin/lnctl"
```
