快连Linux命令行版安装与配置教程

快连除了提供 Windows、macOS、Android、iOS 图形客户端外，也提供 Linux 命令行版本，适合在服务器、云主机、NAS 和无桌面环境的 Linux 发行版中使用。命令行版没有图形界面，全部通过配置文件与终端命令管理，体积小、资源占用低，非常适合长期在后台运行。本文将以主流发行版为例，详细介绍 deb、rpm 和通用 tar 包三种安装方式，以及配置文件编写、systemd 服务管理和常见问题排查，帮助你快速在 Linux 上部署快连。

一、安装前的环境准备

在开始安装之前，请先确认以下条件：

系统架构：支持 x86_64 与 aarch64，可通过 uname -m 查看。
系统版本：建议 Ubuntu 20.04+、Debian 11+、CentOS 7+、Rocky Linux 8+、AlmaLinux 8+ 等主流发行版。
权限：需要 root 或具有 sudo 权限的账户。
网络：安装过程中需要访问快连官网下载安装包。
依赖：部分发行版需要安装 curl、wget、tar 等基础工具。

建议在安装前先执行系统更新，确保依赖库为最新版本：

sudo apt update && sudo apt upgrade -y   # Debian/Ubuntu
sudo dnf update -y                      # Fedora/Rocky/AlmaLinux
sudo yum update -y                      # CentOS 7

二、下载快连Linux版安装包

访问快连官网下载页面，选择 Linux 版本。官网通常会提供三种格式：

格式	适用系统	安装方式
.deb	Ubuntu、Debian、Linux Mint	`dpkg -i` 或 `apt install`
.rpm	CentOS、Fedora、Rocky、AlmaLinux	`rpm -ivh` 或 `dnf install`
.tar.gz	通用，适用于任意发行版	解压后手动放置二进制文件

也可以直接使用命令行下载，以下载 deb 包为例：

wget https://www.kualianbb.com.cn/download/kualian-linux-amd64.deb

下载完成后，可以使用 sha256sum 校验文件完整性，与官网提供的校验值对比。

三、安装方式一：deb 包安装（Debian/Ubuntu）

适用于 Ubuntu、Debian、Linux Mint 等基于 Debian 的发行版。

操作步骤

# 安装 deb 包
sudo dpkg -i kualian-linux-amd64.deb

# 如果提示依赖缺失，自动修复
sudo apt install -f -y

# 验证安装
kualian --version

安装完成后，快连的二进制文件通常位于 /usr/bin/kualian，配置文件位于 /etc/kualian/，日志位于 /var/log/kualian/。

四、安装方式二：rpm 包安装（CentOS/Fedora/Rocky）

适用于 CentOS、Fedora、Rocky Linux、AlmaLinux 等基于 RPM 的发行版。

操作步骤

# 安装 rpm 包
sudo rpm -ivh kualian-linux-x86_64.rpm

# 如果使用 dnf，可以自动处理依赖
sudo dnf install -y ./kualian-linux-x86_64.rpm

# 验证安装
kualian --version

RPM 包的安装路径与 deb 包基本一致，配置文件在 /etc/kualian/，systemd 服务文件在 /usr/lib/systemd/system/kualian.service。

五、安装方式三：通用 tar.gz 包安装

如果你的发行版不是 deb 或 rpm 系，或者没有 root 权限，可以使用通用 tar.gz 包手动安装。

操作步骤

# 解压
tar -zxvf kualian-linux-amd64.tar.gz -C /opt/

# 进入目录
cd /opt/kualian

# 赋予执行权限
chmod +x kualian

# 创建软链接，方便全局调用
sudo ln -s /opt/kualian/kualian /usr/local/bin/kualian

# 验证
kualian --version

通用包不包含 systemd 服务文件，需要手动创建服务单元（见下文“systemd 服务管理”部分）。

六、配置文件编写

快连 Linux 版的核心配置文件通常为 /etc/kualian/config.yaml 或 /etc/kualian/config.json，具体格式以安装包内附带的示例文件为准。以下是一个常见的 YAML 配置示例：

# /etc/kualian/config.yaml
account:
  username: "your_account@example.com"
  password: "your_password"

connection:
  mode: "tun"          # tun 或 proxy
  protocol: "ktp"      # 快连自研 KTP 协议
  auto_connect: true
  node: "auto"         # auto 表示自动选择最优节点

dns:
  mode: "remote"       # remote 或 local
  servers:
    - "1.1.1.1"
    - "8.8.8.8"

log:
  level: "info"        # debug / info / warn / error
  path: "/var/log/kualian/kualian.log"

配置完成后，建议先以调试模式启动，确认账号登录和节点连接正常：

sudo kualian --config /etc/kualian/config.yaml --log-level debug

安全提示：配置文件中包含账号密码，建议将文件权限设置为 600，仅允许 root 读取：

sudo chmod 600 /etc/kualian/config.yaml
sudo chown root:root /etc/kualian/config.yaml

七、systemd 服务管理

为了让快连在后台稳定运行，并支持开机自启，建议使用 systemd 管理。deb 和 rpm 包通常已自带服务文件，通用 tar 包需要手动创建。

创建服务文件（通用包）

sudo tee /etc/systemd/system/kualian.service > /dev/null <<'EOF'
[Unit]
Description=Kualian Linux Client
After=network-online.target
Wants=network-online.target

[Service]
Type=simple
ExecStart=/usr/local/bin/kualian --config /etc/kualian/config.yaml
Restart=on-failure
RestartSec=5
LimitNOFILE=65535

[Install]
WantedBy=multi-user.target
EOF

启用与启动服务

# 重新加载 systemd 配置
sudo systemctl daemon-reload

# 设置开机自启
sudo systemctl enable kualian

# 启动服务
sudo systemctl start kualian

# 查看状态
sudo systemctl status kualian

# 查看实时日志
sudo journalctl -u kualian -f

八、验证连接是否生效

服务启动后，可以通过以下方式验证快连是否正常工作：

执行 kualian status 查看当前连接状态与节点信息。
执行 curl -I https://www.google.com，确认可以正常访问海外站点。
执行 ip addr show，查看是否出现快连虚拟网卡（通常命名为 kualian0 或 tun0）。
执行 kualian node list，确认可用节点列表。

九、常见问题排查

1. 启动时提示“权限不足”或“无法创建 TUN 设备”

快连需要创建 TUN 虚拟网卡，必须具有 root 权限。请使用 sudo 启动，或确认 systemd 服务以 root 运行。同时检查系统是否加载了 tun 模块：

sudo modprobe tun
lsmod | grep tun

2. 连接成功但无法访问外网

可能是 DNS 或路由表异常。可以尝试：

将配置中的 dns.mode 改为 local，使用系统 DNS。
检查 ip route，确认默认路由是否指向快连虚拟网卡。
执行 kualian restart 重新建立连接。

3. systemd 服务启动失败

使用 sudo journalctl -u kualian -n 100 --no-pager 查看详细错误。常见原因包括配置文件路径错误、账号密码错误、二进制文件权限不足等。

4. 服务器重启后快连未自动启动

确认已执行 sudo systemctl enable kualian。如果仍不自启，检查 WantedBy 是否为 multi-user.target，并确认 network-online.target 已就绪。

5. 日志中出现大量重连记录

通常与节点不稳定或网络抖动有关。可以尝试在配置中固定一个低负载节点，或开启 auto_connect 与 RetryInterval 参数，减少频繁重连。

十、升级与卸载

升级

deb 和 rpm 包直接下载新版本覆盖安装即可，配置文件会保留。通用 tar 包需要先停止服务，替换二进制文件后重新启动。

# deb 升级
sudo dpkg -i kualian-linux-amd64-new.deb

# rpm 升级
sudo rpm -Uvh kualian-linux-x86_64-new.rpm

# systemd 重启
sudo systemctl restart kualian

卸载

# deb 卸载
sudo apt remove --purge kualian -y

# rpm 卸载
sudo rpm -e kualian

# 通用包卸载
sudo systemctl stop kualian
sudo systemctl disable kualian
sudo rm -f /etc/systemd/system/kualian.service
sudo rm -rf /opt/kualian /etc/kualian /var/log/kualian

十一、总结

快连 Linux 命令行版体积小、资源占用低，非常适合在服务器、云主机和无桌面环境中长期运行。通过本文介绍的 deb、rpm 和通用 tar 包三种安装方式，配合配置文件编写与 systemd 服务管理，你可以在几分钟内完成部署并让快连在后台稳定加速。遇到无法创建 TUN 设备、DNS 异常或服务启动失败时，按照第九部分的排查方法逐项检查，大多数问题都能快速解决。

建议始终从快连官网下载最新 Linux 安装包，并在升级系统或内核后重新验证 TUN 模块和虚拟网卡状态。如果你在部署过程中遇到本文未覆盖的问题，可以整理系统版本、内核版本和日志片段，通过快连官网客服渠道提交工单，获取进一步支持。