本帖旨在成为官方文档中 排障指南 的补充，记录一些更为琐细的问题。不定期更新。

注：如果您是遇到 bug 或者设计缺陷，请于对应项目的 Issues 中寻找/提出问题。

---

Dashboard

使用后台安装命令无法添加任何服务器

需要检查 install_host（即设置中的 “Agent 对接地址”）是否填写正确。

install_host 仅用于管理后台生成安装命令，所以并不会使 Dashboard 在额外的地址上监听。因此需要确保其值为能够访问到您的 Dashboard 实例的地址。端口值应该与 Dashboard 或是上层应用（例如反向代理）中所配置的监听端口一致。

---

私有备注不显示

目前只有公开备注被设计为用于前端自定义功能，而私有备注没有额外的功能。

---

面板配置使用 CDN 的请求头获取 Real IP，如何不经过 CDN 连接 Agent

可以在反向代理中配置请求头的映射，例如在 Nginx 中可以在 CDN 请求头的值不符合要求的情况下，将连接地址映射为 Real IP 的变量值：

server {
    ...

    underscores_in_headers on;
    location ^~ /proto.NezhaService/ {
        ...
        grpc_set_header nz-realip $client_ip;
        ...
    }

    ...
}

map $http_cf_connecting_ip $client_ip {
    default          $remote_addr;
    "~^[0-9]"        $http_cf_connecting_ip; 
}

---

更新 Dashboard 时脚本显示过多镜像

可以运行 docker image prune 清理过时镜像。

---

复制安装命令时报错 Failed to execute ‘insertBefore’ on ‘Node’ …

请更新您的浏览器或者关闭会影响页面内容的插件后再试。

---

无法删除服务器

需要先卸载对应服务器的 Agent（参见 卸载 Agent），之后再在 Dashboard 上删除。

---

Agent

启动报错：获取 service logger 时出错: Unix syslog delivery error…

尝试更换新的系统，或者无视此报错（只影响写入 syslog，不影响其它功能使用）

---

无法连接上 Dashboard，报错 context deadline exceeded

检查到 Dashboard 的网络连接是否通畅，或者在配置中使用自定义 DNS 服务器（例如国内机器可以改用国内 DNS 服务器）。