workbuddy在腾讯云服务器安装频繁超时，主因是内网带宽不足、dns解析绕行及未启用vpc内网直连；需统一vpc/可用区、升级内网带宽、切换腾讯云内网dns与镜像源，并配置dscp优先级标记。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在腾讯云服务器上安装WorkBuddy时频繁遭遇网络超时，很可能是由于内网带宽配置不足、内网流量调度策略不合理或跨可用区通信延迟所致。以下是解决此问题的具体操作路径：
一、检查并启用内网直连通信
WorkBuddy组件间（如前端服务、后端API、数据库、消息队列）默认依赖内网通信。若未启用同地域同VPC下的内网直连，请求可能绕行公网或经由NAT网关，显著增加延迟并触发超时。需确认所有资源部署在同一VPC及可用区内，并关闭非必要公网出口。
1、登录腾讯云控制台，进入【私有网络 VPC】页面。
2、选择对应地域，点击目标VPC名称进入详情页。
3、在左侧菜单中选择【子网】，确认WorkBuddy各服务实例所绑定的子网均属于该VPC且处于同一可用区。
4、进入【云服务器 CVM】列表，筛选所有相关实例，在“网络信息”栏核对“内网IP”是否全部为10.0.0.0/8、172.16.0.0/12或192.168.0.0/16网段地址，且无公网IP被意外绑定。
5、在【安全组】中检查入站规则，确保TCP端口（如8080、3306、6379等）对内网IP段（如10.0.0.0/8）开放，而非仅对0.0.0.0/0开放。
二、调整CVM实例内网带宽上限
腾讯云CVM默认内网带宽受实例规格限制，部分共享型或入门型实例内网带宽上限仅为1Gbps甚至更低，无法满足WorkBuddy多模块并发拉取依赖包、同步镜像或传输配置文件的需求。需升级实例规格或启用带宽弹性模式。
1、进入【云服务器 CVM】控制台，定位到运行WorkBuddy安装脚本的目标实例。
2、点击实例ID进入详情页，在【更多操作】下拉菜单中选择【调整配置】。
3、在配置变更页面，勾选【带宽按使用量计费】或切换至更高网络性能规格（如标准型S6升级为计算型C6），注意勾选【同时调整内网带宽】选项。
4、提交变更并重启实例，重启完成后执行ethtool eth0 | grep Speed验证内网网卡协商速率为10000Mb/s（即10Gbps）。
三、优化内网DNS解析路径
WorkBuddy安装过程常调用apt-get、yum或npm install，其依赖源域名（如mirrors.tencent.com、registry.npmjs.org）若经公网DNS解析，可能引入跨AZ路由跳转与递归查询延迟。应强制使用腾讯云内网DNS服务器，避免解析路径绕行。
1、登录CVM实例，执行cat /etc/resolv.conf确认当前DNS配置。
2、备份原配置：sudo cp /etc/resolv.conf /etc/resolv.conf.bak。
3、编辑配置文件：sudo nano /etc/resolv.conf，将原有nameserver行全部替换为：
nameserver 100.100.2.136
nameserver 100.100.2.138
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
4、添加防止覆盖指令：sudo chattr +i /etc/resolv.conf。
5、测试解析效率：time nslookup mirrors.tencent.com，确保响应时间稳定低于10ms。
四、启用VPC内网流量优先级标记
当WorkBuddy安装涉及大量小包交互（如Git克隆、Docker layer下载），默认DSCP值为0，易被腾讯云底层QoS策略降权。通过设置DSCP标记为CS6（十进制48），可使内网流量获得最高调度优先级，规避队列丢包与缓冲膨胀。
1、在WorkBuddy安装脚本执行前，于CVM中运行以下命令配置出口策略：
sudo tc qdisc add dev eth0 root handle 1: htb default 30
sudo tc class add dev eth0 parent 1: classid 1:1 htb rate 10gbit
sudo tc class add dev eth0 parent 1:1 classid 1:30 htb rate 10gbit prio 0
2、对WorkBuddy安装进程打标：
sudo iptables -t mangle -A OUTPUT -m owner --uid-owner workbuddy -j DSCP --set-dscp 48
3、验证标记生效：sudo tcpdump -i eth0 -n -c 5 'ip[1] & 0xfc == 192'（DSCP 48对应二进制11000000，高位6位为110000）。
五、替换为腾讯云内网软件源镜像
WorkBuddy安装依赖系统包管理器（如APT/YUM）从远程仓库拉取基础组件。若使用默认境外源（archive.ubuntu.com、repo.mysql.com），即使走内网也会因跨地域缓存缺失导致回源延迟。必须切换至腾讯云官方内网镜像站，所有域名均解析为100.x.x.x内网地址。
1、Ubuntu系统执行：
sudo sed -i 's/archive.ubuntu.com/mirrors.tencentyun.com/g' /etc/apt/sources.list
sudo sed -i 's/security.ubuntu.com/mirrors.tencentyun.com/g' /etc/apt/sources.list
2、CentOS系统执行：
sudo sed -i 's|mirrorlist=|#mirrorlist=|g' /etc/yum.repos.d/CentOS-Base.repo
sudo sed -i 's|#baseurl=http://mirror.centos.org|baseurl=https://mirrors.tencentyun.com|g' /etc/yum.repos.d/CentOS-Base.repo
3、刷新缓存：sudo apt-get update 或 sudo yum makecache，观察输出中所有URL均为https://mirrors.tencentyun.com且无HTTP 302跳转。
