首次运行

在 Debian / Ubuntu、Fedora / RHEL 或 openSUSE 上安装 honk 软件包后，按本页配置并启动服务。

已配置 sudo 的普通用户选择 sudo 标签；已进入 root shell 时选择 root 标签。

1. 配置 honk

首次安装时，将以下仅直连配置保存为当前目录下的 config.dae。把 br-lan 替换为接收客户端流量的 LAN 接口；只处理本机流量时，删除 lan_interface。wan_interface: auto 跟随 IPv4 默认路由。

global {
    wan_interface: auto
    lan_interface: br-lan
    data_dir: '/var/lib/honk'
    log_level: info
    dial_mode: domain
    auto_config_kernel_parameter: true
}

routing {
    fallback: direct
}

如果 /etc/honk/config.dae 已存在，请保留并跳过此步；否则以限制访问的权限安装配置文件：

sudo

sudo install -d -m 0700 /etc/honk /var/lib/honk
sudo install -m 0600 ./config.dae /etc/honk/config.dae

root

install -d -m 0700 /etc/honk /var/lib/honk
install -m 0600 ./config.dae /etc/honk/config.dae

启动前，按实际网络修改 /etc/honk/config.dae。内核要求和最小配置见如何开始。

软件包已内嵌 doona。要启用网页界面，请将以下配置加入配置文件；如果已有 experimental 小节，将内容合并到该小节：

experimental {
    native_api {
        enabled: true
        listen: '127.0.0.1:9527'
        password_auth: true
        config_write: true
        ui: 'embedded'
    }
}

2. 启动服务

如果已安装 dae，请先停止服务并禁用开机自启，再启动 honk：

sudo

sudo systemctl disable --now dae.service

root

systemctl disable --now dae.service

sudo

sudo systemctl enable --now honk.service

root

systemctl enable --now honk.service

检查服务是否在运行，输出应显示 active (running)：

sudo

sudo systemctl status honk.service --no-pager

root

systemctl status honk.service --no-pager

若未运行，查看本次启动的最近 50 行日志：

sudo

sudo journalctl -u honk.service -b -n 50 --no-pager

root

journalctl -u honk.service -b -n 50 --no-pager

在 honk 所在主机上打开 http://127.0.0.1:9527/ui/，首次访问时创建管理员账号。

下一步

• 首次登录：打开 http://127.0.0.1:9527/ui/，创建管理员账号。
• 管理节点、策略组和规则：添加节点或订阅和路由规则；在此之前所有流量直连。
• 故障排除：无法正常使用时的排查步骤。