MirageServer 项目常见问题解决方案

MirageServer 项目常见问题解决方案

MirageServer 蜃境：基于Headscale修改的带WebUI开源版本Tailscale控制器 项目地址: https://gitcode.com/gh_mirrors/mi/MirageServer

一、项目基础介绍

MirageServer 是一个基于 Headscale 修改的开源版本 Tailscale 控制器，带有 WebUI 界面。该项目旨在为用户提供一种易于配置和管理的零信任网络解决方案。主要编程语言包括 Vue (前端) 和 Go (后端)。

二、新手常见问题及解决步骤

问题一：项目启动失败，无法访问默认的超管控制台

问题描述：项目编译后运行，但无法通过默认端口（8081）访问超管控制台。

解决步骤：

1. 检查是否有其他服务占用了8081端口，可以使用命令 netstat -tulnp | grep 8081 检查。
2. 如果有其他服务占用，需要修改端口或关闭占用端口的服务。修改端口可以通过设置环境变量实现，如 export MIRAGE_SYS_ADDR="127.0.0.1:18081"。
3. 重新启动项目，尝试访问新的端口。

问题二：无法进行超管绑定，无法启动控制器服务

问题描述：首次启动项目，无法通过 WebAuthn 方式绑定超级管理员，控制器服务无法启动。

解决步骤：

1. 确保浏览器支持 WebAuthn，并且已正确安装了必要的安全设备，如 Yubikey 或使用支持 WebAuthn 的苹果设备。
2. 检查是否有网络连接问题，导致无法接收认证挑战。
3. 在超管控制台页面检查错误信息，根据提示进行操作，确保正确完成了认证流程。

问题三：客户端版本发布失败

问题描述：在超管控制台上尝试发布客户端版本时，发布失败。

解决步骤：

1. 确认客户端版本文件是否正确上传到了服务器上。
2. 检查服务器是否有足够的权限访问上传的版本文件。
3. 确认版本信息是否正确填写，包括版本号和版本描述。
4. 如果以上步骤均无问题，尝试重启服务，然后再次发布客户端版本。

通过以上步骤，新手用户可以解决在使用 MirageServer 项目过程中遇到的一些常见问题。

MirageServer 蜃境：基于Headscale修改的带WebUI开源版本Tailscale控制器 项目地址: https://gitcode.com/gh_mirrors/mi/MirageServer