# Nuitka 极简入门与高频打包命令速查表

Python项目开发后，经常有需要编译成exe文件的需求，而官方提供PyInstaller打包的程序源码容易被反编译，运行速度慢。Nuitka就是为你准备的完美替代方案。本文提取了 Nuitka 部署中最核心的安装步骤、高频打包命令以及防坑技巧。建议收藏，作为Python项目编译发布的速查备忘录。



---

## 快速安装指南

根据你的开发系统，选择对应的环境准备方式。Nuitka 依赖 C 编译器将代码转化为机器码。

### 方式 A：Windows 环境（推荐依赖 Nuitka 自动配置）

在 Windows 上不需要手动折腾复杂的 C 环境，直接安装 Nuitka，它会在首次运行时自动帮你搞定 MinGW64。

```bash
# 1. 激活你的 Python 虚拟环境，直接安装
pip install nuitka

# 2. 首次运行测试（如果提示下载 C 编译器，输入 Yes 回车即可）
python -m nuitka --version
```

### 方式 B：Linux / macOS 环境（系统自带编译器）

Linux 和 macOS 通常已经自带了 `gcc` 或 `clang`，直接安装即可开箱即用。

```bash
# Ubuntu/Debian 确保有基础编译环境
sudo apt install build-essential

# 安装 Nuitka
pip install nuitka
```

---

## 一、 三大核心概念

动手敲命令前，只需记住 Nuitka 的这三个核心逻辑：

* **C 语言级编译**：与 PyInstaller 的“打包+自解压”不同，Nuitka 是将 Python 翻译成 C 代码，再编译成底层机器码。因此**极难反编译**，且计算密集型代码**运行速度更快**。
* **独立运行环境 (Standalone)**：发给没有 Python 环境的电脑运行的基石。它会将解释器和所有依赖的 dll/so 动态链接库全部提取到一个文件夹中。
* **插件系统 (Plugins)**：处理复杂第三方库（如 NumPy、PyQt、OpenCV 等）的灵魂。很多动态加载的库 Nuitka 静态分析不到，必须通过开启官方插件来兼容。

---

## 二、 高频打包命令模板

在项目根目录下执行。直接套用以下模板即可搞定 90% 的场景。

### 1. 基础单文件打包（适用于简单脚本/CLI工具）

将所有内容压缩成一个干净的 `.exe` 或 `.bin` 文件。启动时会在临时目录解压，速度稍慢。

```bash
python -m nuitka --onefile main.py
```

### 2. 独立文件夹模式（适用于大型工程/服务端部署）

生成一个 `.dist` 文件夹，启动速度最快，适合部署在服务器上（如 FastAPI 后端或 AI 推理服务）。

```bash
python -m nuitka --standalone main.py
```

### 3. 带界面的桌面程序（隐藏控制台黑框）

打包 PyQt/Tkinter 等 GUI 程序时，禁用背后的命令行窗口，并指定程序图标。

```bash
python -m nuitka --onefile --windows-console-mode=disable --windows-icon-from-ico=logo.ico main.py
```

### 4. 复杂 AI/数据科学项目（启用特定插件）

使用了 NumPy、Pandas 或 OpenCV 等重型库，必须显式启用对应插件。

```bash
python -m nuitka --standalone --enable-plugin=numpy --enable-plugin=opencv main.py
```

---

## 三、 常用编译参数速查

除了套用模板，以下参数在微调打包结果时极为常用：

* **查看所有可用插件**：`python -m nuitka --plugin-list`
* **强制包含隐式模块**：`--include-module=模块名`（解决代码中用 `__import__` 动态引入导致打包漏掉的问题）
* **包含额外数据文件**：`--include-data-dir=/源码目录=/目标目录`（用于打包配置文件、模型权重、静态资源等）
* **精简无用体积**：`--noinclude-pytest-mode=pytest`（防止 Nuitka 把测试库也打包进去导致体积膨胀）

---

## 四、 进阶排错与实用技巧

* **致命大坑：路径千万别带中文！** 无论是你的项目源码路径、Python 安装路径，还是系统的临时目录变量，**绝对不能有中文或空格**，否则 C 编译器会直接报错退出。
* **杀毒软件误杀**：自己编译的单文件 `.exe` 极易被 360 或 Windows Defender 秒删。开发时建议将项目目录加入杀软白名单，发布时推荐使用 `--standalone` 文件夹模式，误杀率会低很多。
* **运行报错 `ModuleNotFoundError`**：这是最常见的错误。说明某个第三方包底层用了动态导入，Nuitka 没发现。解决方法是在编译命令中加上 `--include-package=报错的包名`。

---

**总结：**
Nuitka 的配置哲学就是“用编译换取安全和性能”。掌握 `--standalone` 核心模式，遇到复杂库就找 `--enable-plugin`，遇到少包就用 `--include-module`，你就能轻松应对绝大多数的 Python 商业化交付和多端部署场景。

Nuitka使用教程

# OpenCode 官方安装与使用教程

本文档基于 OpenCode 官方文档整理，专为终端打造的开源 AI 编码代理（AI Coding Agent）。



## 1. 安装要求与准备

要在终端中使用 OpenCode，你需要：
1. **一款现代终端模拟器**，例如：
   - WezTerm（跨平台）
   - Alacritty（跨平台）
   - Ghostty（Linux 和 macOS）
   - Kitty（Linux 和 macOS）
2. **LLM 提供商的 API 密钥**（你打算使用的大模型 API Key）。

---

## 2. 安装方式

OpenCode 支持多种安装方式，请根据你的操作系统和环境选择最适合的一种。

### 2.1 最简安装（通过安装脚本）
```bash
curl -fsSL [https://opencode.ai/install](https://opencode.ai/install) | bash
```

### 2.2 使用 Node.js 包管理器
如果你已经安装了 Node.js 环境，可以通过以下包管理器全局安装：
```bash
# 使用 npm
npm install -g opencode-ai

# 使用 Bun
bun install -g opencode-ai

# 使用 pnpm
pnpm install -g opencode-ai

# 使用 Yarn
yarn global add opencode-ai
```

### 2.3 macOS / Linux 环境
**使用 Homebrew：**
推荐使用 OpenCode tap 以获取最新版本：
```bash
brew install anomalyco/tap/opencode
```

**使用 Arch Linux：**
```bash
sudo pacman -S opencode     # Arch Linux (Stable)
paru -S opencode-bin        # Arch Linux (Latest from AUR)
```

### 2.4 Windows 环境
**强烈推荐使用 Windows Subsystem for Linux (WSL)** 以获得最佳体验、性能和完全兼容性。如果在 Windows 原生环境中安装：

```bash
# 使用 Chocolatey
choco install opencode

# 使用 Scoop
scoop install opencode

# 使用 NPM
npm install -g opencode-ai

# 使用 Mise
mise use -g github:anomalyco/opencode

# 使用 Docker
docker run -it --rm ghcr.io/anomalyco/opencode
```
*(注：你也可以直接从其 GitHub Releases 页面下载对应的二进制文件。)*

---

## 3. 配置与初始化

### 3.1 配置大模型 (API Key)
通过 OpenCode，你可以配置 API 密钥来使用任意 LLM 提供商。如果你刚开始接触，官方推荐使用 **OpenCode Zen**（一组经过团队测试验证的精选模型组合）。

1. 启动工具并输入命令连接：
   打开终端运行 `opencode`，在 TUI 界面中输入：
   ```text
   /connect
   ```
2. 选择提供商（如 `opencode`），然后前往 `opencode.ai/auth` 获取并复制 API 密钥。
3. 在终端的 `┌ API key` 提示处粘贴密钥并回车。

### 3.2 初始化项目
配置好提供商后，将 OpenCode 引入你的实际项目中：

1. 导航到你想要处理的项目目录：
   ```bash
   cd /path/to/project
   ```
2. 运行 OpenCode：
   ```bash
   opencode
   ```
3. 执行初始化命令：
   ```text
   /init
   ```
   OpenCode 会自动分析你的项目，并在项目根目录创建一个 `AGENTS.md` 文件。
> **💡 提示**：建议将 `AGENTS.md` 文件提交到你的 Git 仓库中。这有助于 OpenCode 深入理解你的项目结构和编码规范。

---

## 4. 常用使用方式

现在你已经准备好使用 OpenCode 来处理项目了，可以直接在对话框中向它提问或下达指令。

### 4.1 提问与代码阅读
你可以让 OpenCode 为你讲解代码库，遇到不熟悉的代码时非常有用。
> **💡 提示**：在对话中输入 `@` 键可以模糊搜索并引入项目中的具体文件。

**示例**：
```text
How is authentication handled in @packages/functions/src/api/index.ts
```

### 4.2 制定计划与添加功能（Plan 模式）
当你需要添加新功能时，建议先让 AI 制定一个计划。
1. **切换到计划模式**：按下 `<TAB>` 键切换到“计划模式”（Plan Mode）。在此模式下，它不会进行任何实质性修改，只会给出代码实现建议。右下角会有模式指示器。
2. **描述需求**：提供足够细节，就像和初级开发者沟通一样。
   ```text
   When a user deletes a note, we'd like to flag it as deleted in the database.
   Then create a screen that shows all the recently deleted notes.
   ```
3. **补充图像上下文**：你可以直接将图片拖放到终端窗口中，OpenCode 会扫描图片并将其作为参考添加到提示词中。
   ```text
   Take a look at this image and use it as a reference.
   ```
4. **实施计划（Build 模式）**：对计划满意后，再次按下 `<TAB>` 键切换回“构建模式”（Build Mode），然后让它开始修改代码：
   ```text
   Sounds good! Go ahead and make the changes.
   ```

### 4.3 直接修改代码
对于简单的修改，你可以跳过计划阶段，直接让 OpenCode 实施：
```text
We need to add authentication to the /settings route. Take a look at how this is handled in the /notes route in @packages/functions/src/notes.ts and implement the same logic in @packages/functions/src/settings.ts
```

### 4.4 撤销与重做修改
如果 OpenCode 做的修改不符合预期，你可以轻松回退：
* 输入 `/undo`：OpenCode 会还原刚刚所做的文件修改，并将你之前的提示词重新填入输入框，方便你微调后重试。你可以多次运行 `/undo` 撤销多步操作。
* 输入 `/redo`：重做被撤销的修改。

### 4.5 分享对话
你可以将与 OpenCode 的精彩对话分享给团队：
* 输入 `/share`：这会生成当前对话的网页链接并自动复制到剪贴板。（注意：默认情况下对话是私密的，只有主动执行命令才会被分享）。

OpenCode官方安装与使用教程

# Caddy 实用入门与常用配置速查表

在现代 Web 服务部署中，配置 HTTPS 证书和反向代理往往是让人头疼的环节。Caddy 的出现完美解决了“配置繁琐、忘记续签证书”的经典难题。本文将带你从零开始安装 Caddy，快速梳理核心概念，并汇总个人博客部署和日常服务器运维中最常用的配置模版与命令，建议收藏作为手边备忘录。---



## Caddy 的官方推荐安装方式

根据你的使用习惯，Caddy 官方提供了多种安装方式。这里介绍最常用的包管理器安装和 Docker 容器化安装。

### 方式 A：Debian/Ubuntu 官方源安装 (推荐物理机/云服务器)

这是官方最推荐的生产环境安装方式。依次执行以下命令，添加官方 Cloudsmith 仓库并安装：

```bash
# 1. 安装必要的依赖（包含 curl 和 gpg 等）
sudo apt install -y debian-keyring debian-archive-keyring apt-transport-https curl

# 2. 添加官方 GPG 密钥
curl -1sLf '[https://dl.cloudsmith.io/public/caddy/stable/gpg.key](https://dl.cloudsmith.io/public/caddy/stable/gpg.key)' | sudo gpg --dearmor -o /usr/share/keyrings/caddy-stable-archive-keyring.gpg

# 3. 添加 Caddy 官方源列表
curl -1sLf '[https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt](https://dl.cloudsmith.io/public/caddy/stable/debian.deb.txt)' | sudo tee /etc/apt/sources.list.d/caddy-stable.list

# 4. 更新软件源并安装 Caddy
sudo apt update
sudo apt install caddy
```

通过此方式安装后，Caddy 会自动注册为 Systemd 服务并默认开机自启。你可以通过 `sudo systemctl status caddy` 查看运行状态。

### 方式 B：Docker 一键运行 (推荐容器化玩家)

如果你更喜欢隔离的容器环境，可以直接拉取官方镜像运行。注意要将端口和必要的目录挂载出来以持久化数据和证书：

```bash
docker run -d -p 80:80 -p 443:443 -p 443:443/udp \
    --name caddy \
    -v /您的绝对路径/Caddyfile:/etc/caddy/Caddyfile \
    -v caddy_data:/data \
    -v caddy_config:/config \
    caddy:alpine
```
*(注：`caddy_data` 卷极其重要，它保存了 Caddy 自动申请的 TLS 证书。如果没有持久化这个目录，每次重建容器都会重新申请证书，极易触发 Let's Encrypt 的请求频率限制)*

---

## 一、 Caddy 核心概念速览

在开始写配置之前，理解以下三个核心概念会让你的部署更加得心应手：

* **Caddyfile**：Caddy 的专属配置文件，默认路径通常在 `/etc/caddy/Caddyfile`。它的语法极其简洁，摒弃了 Nginx 中那些冗长的分号和复杂的结构。
* **自动 HTTPS (Automatic HTTPS)**：Caddy 的杀手锏。只要你在 Caddyfile 中绑定了有效的公网域名（且域名 A 记录已解析到该服务器），Caddy 就会在后台自动向 Let's Encrypt 或 ZeroSSL 申请证书，并在到期前自动续签。
* **反向代理 (Reverse Proxy)**：最常用的功能。它像是一个“前台接待”，负责将外部互联网通过 80/443 端口发来的请求，安全地转发给服务器内部运行的实际应用（比如运行在 8000 端口的容器服务）。

---

## 二、 常用配置模版 (Caddyfile Configuration)

修改配置只需编辑 `/etc/caddy/Caddyfile` 文件。以下是日常建站和部署服务的高频配置代码：

### 1. 基础反向代理（博客/API/面板）

* **代理本地端口**：
  *(例如：你部署了某博客系统，内部映射到本地 `8000` 端口。只需两行即可实现外部域名访问 + HTTPS)*

  ```caddy
  blog.yourdomain.com {
      reverse_proxy localhost:8000
  }
  ```

### 2. 静态网站托管

* **指定目录映射**：
  *(如果你只有纯 HTML/CSS/JS 的静态页面)*

  ```caddy
  [www.yourdomain.com](https://www.yourdomain.com) {
      root * /var/www/mysite
      file_server
  }
  ```

### 3. 多域名与重定向规则

* **WWW 跳转到主域名**：
  *(为了 SEO 和统一入口，强制将带 www 的请求 301 重定向到根域名)*

  ```caddy
  [www.yourdomain.com](https://www.yourdomain.com) {
      redir [https://yourdomain.com](https://yourdomain.com){uri}
  }

  yourdomain.com {
      reverse_proxy localhost:8080
  }
  ```

* **同时为多个域名配置相同服务**：

  ```caddy
  site1.com, site2.com {
      reverse_proxy localhost:3000
  }
  ```

---

## 三、 服务与状态命令 (Service Commands)

配置文件修改后，我们需要告诉 Caddy 重新加载它们：

### 1. 配置检查与格式化

* **校验配置文件语法（核心命令）**：

  ```bash
  caddy validate --config /etc/caddy/Caddyfile
  ```
  *(强烈建议每次修改后、重载前执行此命令，避免因语法错误导致网站宕机)*

* **自动格式化 Caddyfile**：

  ```bash
  caddy fmt --overwrite /etc/caddy/Caddyfile
  ```
  *(自动帮你调整缩进和换行，强迫症福音)*

### 2. 状态控制 (基于 Systemd 安装)

* **平滑重载配置**：`sudo systemctl reload caddy`
  *(服务不会中断，当前连接保持，仅加载新配置。修改 Caddyfile 后最常用的命令)*
* **重启 Caddy 服务**：`sudo systemctl restart caddy`
* **停止 Caddy 服务**：`sudo systemctl stop caddy`

*(注：如果是 Docker 部署，平滑重载配置的命令为 `docker exec -w /etc/caddy caddy caddy reload`)*

---

## 四、 进阶实用技巧 (高阶配置)

这里补充几个在实际排错或特殊网络环境下经常能“救命”的技巧：

* **查看 Caddy 运行日志**：

  ```bash
  journalctl -u caddy --no-pager | tail -n 50
  ```
  *(如果你的域名无法访问，或者证书申请失败，这里通常会打印出 Let's Encrypt 的具体报错原因，比如“DNS 未解析”或“端口被占用”)*

* **本地局域网开发使用自动 HTTPS**：
  如果你的域名是 `localhost` 或以 `.local` 结尾，Caddy 不会去公共机构申请证书，而是会在本地自动生成一个“自签发”证书。

  ```caddy
  localhost {
      reverse_proxy localhost:8080
  }
  ```

* **反向代理时传递真实 IP**：
  *(其实这是个冷知识：与 Nginx 需要手动配置 `X-Forwarded-For` 不同，Caddy 的 `reverse_proxy` 指令**默认**就会自动传递真实的客户端 IP 头信息，无需额外写任何代码！)*

---

**总结：**
Caddy 的配置哲学就是“约定优于配置”。掌握了 `reverse_proxy` 和 `file_server` 这两个核心指令，结合 `systemctl reload caddy` 或 Docker 对应命令实现无缝更新，你就能轻松应对绝大多数的个人博客建站、容器代理和日常 Web 部署场景。

Caddy使用教程

# Docker 实用入门与常用命令速查表

在现代软件开发和部署中，Docker 已经成为了不可或缺的工具。它完美解决了“在我的机器上明明能跑”的经典难题。本文将带你从零开始安装 Docker，快速梳理核心概念，并汇总日常开发和服务器运维中最常用的命令，建议收藏作为手边备忘录。

---

## Docker 的一键安装与启动

对于大多数 Linux 发行版（如 Ubuntu、Debian、CentOS 等），Docker 官方提供了一个非常方便的一键自动化安装脚本，这也是在服务器上最快捷的安装方式。

**1. 运行一键安装脚本：**
```bash
curl -fsSL [https://get.docker.com](https://get.docker.com) -o get-docker.sh
sudo sh get-docker.sh
```

**2. 启动 Docker 服务：**
```bash
sudo systemctl start docker
```

**3. 设置 Docker 开机自启：**
```bash
sudo systemctl enable docker
```

*(可选优化) 避免每次敲命令都要加 `sudo`：*
如果你当前使用的是非 root 用户，建议将当前用户加入 `docker` 用户组，这样以后执行 `docker` 命令就不需要提权了（执行后需退出终端重新登录生效）：
```bash
sudo usermod -aG docker $USER
```

---

## 一、 Docker 核心概念速览

在死记硬背命令之前，理解以下三个核心概念会让你的操作更加得心应手：

* **镜像 (Image)**：可以理解为一个只读的安装包或者系统快照。它包含了运行应用程序所需的所有代码、运行环境、库和配置文件。
* **容器 (Container)**：镜像运行时的实体。如果说镜像是类（Class），那么容器就是对象（Object）。你可以创建、启动、停止、删除容器，各个容器之间是相互隔离的。
* **仓库 (Registry)**：集中存放镜像的地方（最著名的是 Docker Hub）。你可以从仓库拉取（Pull）别人做好的镜像，也可以将自己构建的镜像推送（Push）上去。

---

## 二、 镜像相关命令 (Image Commands)

镜像是容器运行的基础，以下是日常操作镜像的高频命令：

### 1. 查找与获取镜像
* **搜索镜像**：
    ```bash
    docker search <关键词>
    ```
  *(例如：`docker search nginx` 可以在 Docker Hub 查找相关镜像)*
* **拉取镜像**：
    ```bash
    docker pull <镜像名:标签>
    ```
  *(如果不写标签，默认拉取 `latest` 最新版，例如：`docker pull ubuntu:20.04`)*

### 2. 查看与管理镜像
* **查看本地所有镜像**：
    ```bash
    docker images
    ```
* **删除本地镜像**：
    ```bash
    docker rmi <镜像名/镜像ID>
    ```
  *(注意：如果该镜像有对应的容器正在运行或已停止，需要先删除容器才能删除镜像)*
* **清理悬空镜像（虚悬镜像）**：
    ```bash
    docker image prune
    ```
  *(用于清理那些没有标签、且没有被容器使用的废弃镜像，释放磁盘空间)*

### 3. 构建与推送镜像
* **基于 Dockerfile 构建镜像**：
    ```bash
    docker build -t <镜像名:标签> <dockerfile路径>
    ```
  *(通常在项目根目录执行：`docker build -t myapp:v1 .`，注意末尾的点代表当前目录)*
* **推送镜像到远程仓库**：
    ```bash
    docker push <镜像名:标签>
    ```
  *(推送前通常需要先使用 `docker login` 登录，并确保镜像名包含你的用户名/组织名)*

---

## 三、 容器相关命令 (Container Commands)

容器的生命周期管理是我们日常敲得最多的命令：

### 1. 容器的创建与运行
* **创建并启动容器（核心命令）**：
  ```bash
  docker run -d -p 8080:80 --name <容器名> <镜像名:标签>
  ```
  **常用参数解析：**
  * `-d`: 后台运行容器，并返回容器ID。
  * `-p`: 端口映射，格式为 `宿主机端口:容器内部端口`。
  * `--name`: 为容器指定一个易记的名称。
  * `-v`: 目录挂载，格式为 `宿主机目录:容器内目录`（例如：`-v /data/mysql:/var/lib/mysql`），用于数据持久化。
  * `--rm`: 容器停止后自动删除（适合运行临时测试容器）。

### 2. 状态控制
* **查看运行中的容器**：
    ```bash
    docker ps
    ```
* **查看所有容器（包括已停止的）**：
    ```bash
    docker ps -a
    ```
* **停止运行中的容器**：
    ```bash
    docker stop <容器名/容器ID>
    ```
* **强制停止容器**：
    ```bash
    docker kill <容器名/容器ID>
    ```
* **启动已停止的容器**：
    ```bash
    docker start <容器名/容器ID>
    ```
* **重启容器**：
    ```bash
    docker restart <容器名/容器ID>
    ```

### 3. 进入容器与排错
* **进入运行中的容器终端**：
  ```bash
  docker exec -it <容器名/容器ID> /bin/bash
  ```
  *(注：如果是极简镜像如 Alpine，可能没有 bash，需要将 `/bin/bash` 换成 `sh`)*
* **查看容器日志**：
  ```bash
  docker logs -f --tail 100 <容器名/容器ID>
  ```
  *(参数 `-f` 表示持续实时追踪输出，`--tail 100` 表示仅查看最后 100 行，非常适合排查报错)*
* **查看容器资源占用情况**：`docker stats`
  *(类似 Linux 的 top 命令，实时显示 CPU、内存、网络 IO 占用)*

### 4. 容器的删除与清理
* **删除处于停止状态的容器**：
  ```bash
  docker rm <容器名/容器ID>
  ```
* **强制删除正在运行的容器**：
  ```bash
  docker rm -f <容器名/容器ID>
  ```

---

## 四、 进阶实用命令 (高阶技巧)

这里补充几个在实际应用中经常能“救命”或极大提升效率的命令：

* **宿主机与容器之间拷贝文件**：
  * 从容器拷出：
  ```bash
  docker cp <容器名>:/容器内路径 /宿主机路径
  ```
  * 拷入容器：
  ```bash
  docker cp /宿主机路径 <容器名>:/容器内路径
  ```
* **查看 Docker 磁盘占用情况**：
  ```bash
  docker system df
  ```
* **一键清理（慎用）**：
  ```bash
  docker system prune
  ```
  *(一键清除所有停止的容器、未被任何容器引用的网络、未被使用的所有镜像和构建缓存。如果要顺便清理未被使用的挂载卷，可以加 `-a --volumes`)*

---

**总结：**
Docker 的命令虽然繁多，但其设计逻辑非常清晰。掌握了 `image` 和 `container` 的核心操作规律，结合 `-h` 或 `--help` 随时查阅参数，就能轻松应对绝大多数的开发和部署场景。

Docker使用教程与常用命令

# Synergy 3 指南：从安装到使用

Synergy 是一款强大的软件 KVM（键盘、视频、鼠标）工具，允许您使用一套物理键盘和鼠标无缝控制多台电脑，并支持跨设备剪贴板共享。

---

## 1. 软件概况与准备

Synergy 3 是该系列的最新版本，极大地简化了配置流程，让多设备协同办公变得更加容易。

- **官方下载地址**：[https://symless.com/synergy/download](https://symless.com/synergy/download)
- **支持的操作系统**：Windows、macOS、Linux (Ubuntu, Debian, Fedora, CentOS 等)
- **通用激活码**：
  > `7B76313B70726F3BE5BDAC20E585B33B313B7A7A39323735313040676D61696C2E636F6D3B3B3B7D`
- **网络要求**：所有需要联动的电脑必须连接在**同一个局域网**（同一个 Wi-Fi 或有线网络）下。

---

## 2. 安装与激活步骤 (以 Windows 为例)

*注：macOS 和 Linux 的安装逻辑基本相同，只需下载对应系统的安装包即可。*

### 第一步：下载并运行安装程序
1. 访问上方提供的下载链接，下载适用于您系统的安装包（Windows 系统为 `.msi` 格式）。
2. ![](https://blog.dryhten.site/static/img/7a10cf3cf87b858ed9d7955ffb0aace6.c7534ce0-b2e2-4f31-9f6f-52c036f482c8.webp)
3. 双击下载的 `.msi` 文件开始安装。
4. 如果系统弹出用户账户控制（UAC）提示“是否允许此应用对你的设备进行更改？”，请点击“是”。

### 第二步：激活 Synergy 3
1. 安装完成后，打开 Synergy 软件，点击界面上的 **“Continue with Synergy”**。
2. 在弹出的激活或登录界面中，找到输入序列号/激活码（Serial Key）的选项。
3. 将上方提供的**通用激活码**完整复制并粘贴进去，完成激活。

### 第三步：为电脑命名
1. 激活成功后，系统会要求您为当前电脑设置一个名称（例如：`Windows-Main` 或 `MacBook-Pro`）。
2. **注意**：名称只能包含字母、数字、连字符（`-`）或下划线（`_`），不能包含空格或特殊中文字符。
3. 点击下一步，完成初始设定。
![](https://blog.dryhten.site/static/img/a6f352068c00a41ef607008b93502b78.image.webp)

### 第四步：在其他电脑上重复此操作
1. 在您想要控制的所有其他电脑上，重复上述的下载、安装、输入激活码和命名的步骤。

---

## 3. 配置与使用 Synergy 3

当所有电脑都安装并激活了 Synergy 3 之后，就可以开始配置设备的联动了。

### 1. 确定主控机与被控机
- **主控机（Server）**：直接连接着您实际要使用的物理键盘和鼠标的电脑。
- **被控机（Client）**：没有连接键盘鼠标，准备通过网络被主控机控制的电脑。

### 2. 布局与连接
1. 在主控机上打开 Synergy。得益于 Synergy 3 的自动发现功能，在同一个局域网下，软件会自动检测到其他已安装 Synergy 的电脑。
2. 如果无法发现你的另外一台电脑则在 Add computer 里输入你另外一台电脑的ip进行添加
![90ca3f08-85e7-4a69-a8bd-128709dc0611.png](/static/img/93b8e914fe98717e2614a64b24096562.90ca3f08-85e7-4a69-a8bd-128709dc0611.webp)
3. 在软件的图形化界面中，您会看到代表各个电脑的显示器图标。
4. **拖拽布局**：根据您桌面上显示器的实际物理摆放位置（例如笔记本在左边，台式机屏幕在右边），将电脑图标拖拽到相应的位置。
![8c33ba27-7dc2-43d0-8261-ffa1379907c4.png](/static/img/8e8599b1c7f0ed18a56a76356230a801.8c33ba27-7dc2-43d0-8261-ffa1379907c4.webp)
5. 确认连接后，两台电脑即可建立联动。


### 3. 开始使用
配置完成后，您只需将鼠标指针向屏幕边缘（例如右边缘）移动，鼠标就会“穿透”当前屏幕，直接进入另一台电脑的屏幕中。此时您的键盘输入也会自动切换到鼠标所在的电脑。

![9e5d8dc6-d728-4f0b-adfe-502d2eec9c65.png](/static/img/51b841e45d860c4090d62b1c0e9dc49d.9e5d8dc6-d728-4f0b-adfe-502d2eec9c65.webp)
您还可以直接在一台电脑上复制文本，然后将鼠标移动到另一台电脑上进行粘贴，实现**跨设备剪贴板共享**。

---

## 4. 进阶技巧与常见问题

根据 Synergy 官方使用文档，这里列出几个常用的进阶技巧：

- **开机自启动**：为了保证体验的无缝感，建议在软件设置中开启“开机自启动（Automatically run Synergy on start-up）”。这样每次开机后无需手动打开软件即可直接跨屏操作。
- **添加快捷键切换屏幕**：如果您不喜欢用鼠标划过屏幕边缘来切换控制权，可以在设置中配置快捷键（Add a keyboard shortcut to switch to different computers），通过按下特定按键组合将键鼠焦点直接锁定到某台电脑。
- **锁定鼠标指针（Lock Cursor）**：如果您在玩全屏游戏，可以设置一个快捷键将鼠标临时锁定在当前屏幕内，防止游戏激烈操作时鼠标意外滑出到另一台电脑。
- **防火墙问题**：如果电脑互相无法发现，请检查各台电脑的 Windows 防火墙或杀毒软件，确保 Synergy 被允许通过局域网通信（Synergy 默认使用 `24800` 端口）。
- **Ubuntu粘贴板问题**：请在在系统开机时的账号登录界面点击你的账户，然后在右下角设置里切换到**Ubuntu on Xorg**。