文章指导从 GitHub 拉取项目后，用 Docker 在 Windows、私有云和 NAS 上快速部署与排查。读者需了解 Git、Docker、Compose、Linux 权限、数据持久化备份、安全凭证和基本排错；会用克隆、拉取、构建、运行、日志、进入容器和编排启动等命令；看懂 Dockerfile、编排文件、环境变量文件、说明文档、启动脚本和迁移脚本。Windows 推荐 WSL2 与 Docker Desktop；服务器注意防火墙、自启和 SSH；NAS 挂载需关注权限、性能和数据库一致性。部署流程为克隆、配置环境变量、构建启动、检查日志与端口；故障按拉取、构建、访问、权限、持久化、端口冲突排查。避免密钥入库，先本地跑通再上生产。
文章针对Google Antigravity无法登录的问题，列举了三种常见故障：登录后不跳转、提示“当前账号不可用”、卡在账户设置界面。解决办法分三步：首先检查网络，确认代理支持美区并开启全局代理及TUN模式；其次检查Google账号归属地，若显示为China，需通过官方表单申请修改地址，理由栏选择Other并填写说明文案，等待约半小时后收到修改成功邮件；最后重新授权登录即可。文章还提示Antigravity目前免费，提供Gemini Pro 3和Claude Sonnet 4.5模型，值得试用。
本文记录了自建站从零到上线过程中，解决“动态IPv6家宽+Cloudflare代理+1Panel/OpenResty+Docker部署”架构下三大典型故障的完整排错实战。首先，针对CF报522超时，定位为家宽IPv6前缀动态变化和运营商封锁80/443端口所致，解法是调整DDNS-GO正则匹配最新地址并改用非标端口。其次，针对525 SSL握手失败，明确了需在Cloudflare配置Origin Rules将请求重写至非标端口，并手动修改OpenResty配置文件为`listen 666 ssl http2;`，同时将CF加密模式降级为“完全”而非“严格”。最后，为应对微信针对海外域名的ICP备案拦截，绕过了在Docker容器内放置校验文件的陷阱，直接在Nginx层使用精确匹配规则“原地劫持”并返回校验码，实现秒过认证。文章末尾总结了“网络层-加密层-代理层”三步排错心法，便于读者未来快速定位问题。
当VPS正常且其他设备可用时，本机无法访问通常由“流量泄露”导致：Windows优先使用本地原生IPv6或存在残留路由，使流量绕过代理隧道直连目标。解决分四个阶段：服务端部署WARP双栈，确保出站IP伪装为Cloudflare节点；客户端开启Clash Verge的TUN模式、Fake-IP、严格路由及IPv6全局开关；系统层以管理员权限重置网络堆栈（winsock、IPv4、IPv6）并清空DNS缓存、重启；最终通过BrowserLeaks验证IPv4、IPv6及WebRTC三项指标，确认均为代理IP后，在无痕窗口登录测试。此排查路径可解决绝大多数环境失效问题。
太不容易了！恭喜你终于通关了这个“地狱难度”的奈飞排错副本。 回过头来看，这次的经历简直是一本教科书级别的“从网络底层到硬件解码”的全面排查指南。很多踩坑点极其隐蔽，普通人遇到任何一个都可能直接放弃。你的耐心和敏锐的判断（比如发现手机能看、怀疑动态 IP）是最终破局的关键。
XiaoMusic v0.3.102 存在代码逻辑 Bug：新上传专辑在首次通过语音指令“播放列表 [专辑名]”时，因播放进度记忆字典（playlist2music）中无对应记录，且代码缺少容错处理，导致 KeyError 崩溃。解决思路有三：一是通过 sed 命令将字典读取改为 .get() 安全方式，实现无记录时默认从第一首播放（推荐）；二是先语音点播专辑内任意单曲以生成播放记录，之后再使用列表播放；三是调用 API 接口初始化播放进度。用户可按需选择。
xiaomusic程序启动失败常因8090端口被占用，表现为进程试图监听该端口时发现已被其他进程（含未正常退出的僵尸进程）占用。解决方案首选在Linux或macOS终端使用`lsof -i :8090`或`netstat -tunlp | grep 8090`查找占用进程PID，再用`kill -9 PID`强制结束；若在极空间等NAS环境，需检查端口占用详情并确认进程身份，避免误杀系统关键服务，可按需使用`kill`温和停止或`systemctl stop/restart`管理服务。操作时注意权限（可能需要sudo），确认进程安全后再处理，必要时可重启设备。文章还附有xiaomusic基础与进阶文档链接，涵盖端口修改、Docker安装、配置及NAS部署等常见操作指南。
