在Shadowrocket中配置VMess节点时，uuid直接填入节点编辑页面中标记为“密码”的输入框，这是该字段的唯一填写位置，用户在输入时应将服务商提供的完整uuid字符串复制粘贴至该框，注意删除首尾可能存在的空格或换行符。alterId则需点击编辑页面中的“传输层”或“传输”选项进入二级设置界面，在该界面的底部“额外参数”或“自定义参数”区域找到“alterId”输入框，填入服务商指定的数值，常见的标准值为0或64，不可随意填写。导入分享链接或订阅链接时，Shadowrocket会自动从链接中提取这两个参数并填入对应位置，用户无需手动查找或输入，保存节点后即可尝试连接，因此建议优先使用导入方式避免手动填写出错。配置完成后通过访问IP检测网站确认代理出口地址是否正确，确认通过后将全部节点配置导出备份，确保在多设备同步或应用重装时能够快速恢复完整的VMess认证参数，避免因遗忘或丢失uuid和alterId而反复请求服务商提供配置信息。
VMess协议的节点编辑界面字段分布说明
uuid位于节点编辑页面的密码字段位置
在Shadowrocket中添加或编辑VMess节点时，进入节点编辑页面后首先选择协议类型为“VMess”。完成协议选择后，页面会显示该协议对应的专属配置区域，其中uuid直接填写在“密码”输入框中，这是Shadowrocket开发者为统一各协议界面所做的简化设计。尽管该字段在SS协议中用于填写加密密码，但在VMess协议中该字段被复用为uuid的输入位置。许多用户初次配置时误以为需要寻找名为“uuid”的独立字段，实际上只需将服务商提供的uuid字符串完整复制并粘贴至“密码”框即可完成此项配置。
alterId位于传输层设置的额外参数区域
alterId是VMess协议中的动态端口混淆参数，其配置位置不在节点编辑页面的主区域，而需要进入更深层的设置菜单。用户在节点编辑页面找到“传输层”或“传输”选项并点击进入，在该页面底部或“额外参数”区域可以找到“alterId”输入框。该字段通常默认显示一个数值，建议用户填入服务商提供的具体数值，常见值为0或64。如果服务商的分享链接或订阅内容中包含了alterId参数，Shadowrocket会在导入时自动识别并填入，用户无需手动干预。
导入链接时两个参数自动填充无需手动查找
当用户通过VMess协议的分享链接或二维码添加节点时，Shadowrocket的解析引擎会自动提取链接中的uuid和alterId值，并分别填入对应的“密码”字段和传输层设置中的“alterId”字段。用户只需在应用主界面点击扫描二维码或粘贴链接，系统弹出节点预览窗口后确认信息无误并保存即可，整个过程中用户完全不需要手动寻找这两个参数的填写位置。这一特性大大降低了因不熟悉界面布局而填错位置的概率，建议优先使用导入方式避免手动配置失误。
手动配置VMess节点的完整操作路径
进入节点编辑页面并设置基础参数
用户在Shadowrocket主界面点击右上角的加号图标选择“添加节点”，在弹出的编辑页面顶部首先填写节点备注名称以便于识别，然后下拉找到“类型”选项并选择“VMess”。随后依次填写服务器地址和端口号，这两项为VMess连接的基础网络参数，必须与服务商提供的信息完全一致。完成这些基础配置后，页面中部会出现“密码”输入框，此处即为uuid的填写位置，将服务商提供的uuid字符串完整填入该框。建议直接复制粘贴以避免输入错误，因为uuid是由连字符分隔的36位字符组合，手动输入极易出错。
进入传输层设置填入alterId和其他高级参数
基础参数填写完成后，用户需要滑动页面找到“传输层”或“传输”选项并点击进入二级设置界面。在该界面中，首先确认“网络”类型与服务商提供的信息一致，常见选项包括tcp、kcp、ws、h2和grpc。然后下拉至页面底部，在“额外参数”或“自定义参数”区域找到“alterId”输入框，填入服务商指定的数值。部分版本的Shadowrocket可能将此字段标注为“动态端口混淆”或类似名称，用户需根据实际界面确认。如果服务商提供了“安全”选项如tls或xtls，也应在此界面一并配置。
保存前进行配置完整性检查
所有参数填写完毕后，建议用户在点击保存之前逐项核对自己填写的每个字段。重点核对服务器地址是否包含多余的空格或字符、端口号是否完全正确、uuid是否完整且格式符合标准的8-4-4-4-12结构、alterId数值是否与服务商提供的完全一致。任何一项填写错误都可能导致连接时显示“认证失败”或“超时”等错误提示，而此时排障需要逐一检查所有参数，耗费时间远高于填写时的核对投入。确认无误后点击右上角的“保存”按钮，节点即保存至主列表并可尝试连接。
订阅导入场景下的自动填充机制
订阅链接更新时alterId随节点配置同步刷新
当用户使用Shadowrocket的订阅功能管理VMess节点时，所有节点参数包括uuid和alterId均由服务商的订阅服务器统一配置。用户在Shadowrocket中添加订阅链接后，每次手动下拉刷新或应用自动更新时，系统会从订阅地址拉取最新的节点列表，每个节点中已包含完整的uuid和alterId值，并在导入时自动填入对应字段。服务商如变更节点配置或调整alterId参数，用户无需进行任何手动修改操作，仅需执行一次订阅刷新即可同步获取最新参数，保证所有节点保持与服务器端完全一致的配置状态。
导入后手动修改的参数会在下次刷新时被覆盖
如果用户在订阅拉取的VMess节点上手动修改了uuid或alterId字段，下次执行订阅刷新时，Shadowrocket会使用最新的订阅内容完全覆盖当前节点配置，所有手工修改将被重置为服务端的最新值。这意味着在订阅模式下，用户对单个节点认证参数的定制修改不具备持久性，每次刷新后均需重新应用。如需长期保留自定义参数，建议用户将目标节点复制一份并切换为“手动管理”类型，再在新复制的节点上进行修改，这样既能保留订阅源的自动更新便利，又能独立控制特定节点的个性化参数。
多订阅源混合时各源节点的参数相互隔离
当用户在Shadowrocket中配置了多个不同的订阅链接时，每个订阅源拉取下来的VMess节点都拥有各自独立的uuid和alterId配置，这些参数完全由对应的订阅服务器决定，不同订阅源之间的节点参数互不影响。用户可以在节点列表中同时看到来自多个服务商的VMess节点，每个节点在编辑页面中显示对应的uuid和alterId值，这些值各自独立存储且不会因其他订阅的刷新而发生改变。这种隔离机制确保了用户在切换不同服务商的节点时无需重复配置认证参数，每个节点都独立携带其完整的连接凭证。
参数填写错误时的常见表现与解决方法
连接时提示“认证失败”表明uuid错误
当VMess节点配置中的uuid与服务端记录不匹配时，Shadowrocket在尝试建立连接后会返回“认证失败”的错误提示，此时代理状态栏会显示为红色或断开状态。该错误明确指向uuid字段填写错误，用户需回到节点编辑页面，检查“密码”框中的uuid字符串是否存在多余空格、是否漏掉了某个字符段或是否复制了不完整的值。最常见的错误来源是复制时末尾附带了换行符或空格，建议用户将光标移到字符串首尾手动删除可能存在的隐藏字符后重新保存并测试连接。
连接超时但无明确错误提示可能与alterId有关
如果uuid填写正确但连接始终超时且未能收到明确的认证拒绝响应，问题通常指向alterId配置错误。alterId在VMess协议中用于服务器端与客户端之间的动态端口混淆参数同步，双方数值必须完全一致才能正常建立数据通道。用户应进入节点的传输层设置页面，确认alterId输入框中的数值与服务商提供的数字完全一致，常见的标准值包括0和64，但具体数值由服务端决定，不可随意填写。将alterId修改为正确数值后保存并重新连接，多数超时问题可得到解决。
传输层类型选择错误也会导致连接失败
uuid和alterId填写正确但连接依然失败时，用户应检查传输层设置中的“网络”类型是否与服务端实际配置匹配。VMess协议支持多种传输方式包括tcp、kcp、ws、h2和grpc，每种传输方式在服务端的配置参数不同，客户端选择错误的传输类型将导致握手阶段无法完成。用户可返回节点编辑页面，进入传输层设置确认网络类型，如果是从分享链接或订阅导入的节点，该参数通常已自动配置，用户无需修改。如果是手动配置，需与服务商确认正确的传输类型并选择对应选项，同时注意部分传输类型如ws还需要填写“路径”参数，缺漏同样导致连接失败。
进阶配置中的动态端口与alterId关系
alterId在VMess协议中的安全作用
alterId是VMess协议中用于增强抗探测能力的动态端口混淆参数，其原理是在客户端与服务端之间建立一个共享的随机数生成器种子，双方基于该种子定期变换通信中的某些字段值，使得同一个节点的流量在长时间运行中呈现不同的外部特征。这一机制有效防止了基于固定流量模式进行节点识别的检测手段，增加了深度包检测系统识别VMess流量的难度。参数值越大，动态变化的频率越高，但也会消耗更多系统资源，常见的平衡值是64，在现代VMess实现中部分服务端已将默认值降低至0以在安全性和性能间取得新的平衡。
新版本VMess协议中alterId正逐渐被弃用
随着VMess协议的发展与迭代，最新的协议版本中alterId参数的作用正在弱化，部分新部署的服务端已将alterId固定为0并建议客户端同样设置为0。用户在2023年后新建的VMess节点中如果发现alterId字段被要求填写为0或未明确指定数值，可直接使用0作为默认值。如果服务商提供的是较老协议版本的节点配置，其alterId可能仍为64或更高的自定义数值，此时必须按照服务商指定的数值填写，不可自行改为0。用户可查看服务商的节点说明文档或咨询客服确认具体的alterId配置要求。
alterId与动态端口的区别与联系
部分用户容易将alterId与动态端口混淆，两者的核心区别在于alterId是VMess协议层面的参数，控制的是协议内部数据包的混淆特征变化频率，而动态端口是指代理服务器在运行过程中自动切换监听端口的功能。在Shadowrocket的节点编辑界面中，alterId位于传输层设置的“额外参数”区域，而动态端口功能如果支持通常配置在“高级”或“核心设置”中。两者相互独立，用户分别配置即可，修改alterId不会影响服务器的监听端口，反之亦然，但两者配合使用可显著提升节点的隐蔽性。
配置完成后的连通性测试与数据备份
连接后访问IP检测网站验证出口地址
完成uuid和alterId等全部参数配置后，用户在Shadowrocket主界面选择该VMess节点并开启连接，等待状态栏变为绿色并显示“已连接”提示。随后打开浏览器访问ipinfo.io或whatismyip.com这类IP地址查询网站，确认当前显示的IP地址与代理服务器的出口IP一致，表明代理通道已完全建立且认证通过。如果IP地址仍显示为本地网络的实际地址，说明代理未生效，需检查节点配置或切换至其他节点进行对比测试，排除当前节点配置错误的可能性。
导出配置备份以避免参数丢失
一旦节点配置完成并通过连通性测试，建议用户立即使用Shadowrocket内置的“导出配置”功能将所有节点信息包括uuid和alterId等全部参数导出为配置文件并保存至安全位置。导出操作在应用主界面的设置页面中找到“导出配置”选项，生成的配置文件包含了所有节点的完整加密参数，用户可保存至iCloud云盘、通过AirDrop传输至其他设备或存储至电脑本地。该备份在设备丢失、应用重装或误删除节点时能快速恢复全部配置，避免因遗忘或丢失uuid和alterId参数而重新向服务商索取。
多设备同步时确保各端配置一致
当用户在多台iOS设备上使用相同的VMess节点时，需确保每台设备上该节点的uuid和alterId配置完全一致。最简单的方式是使用上述“导出配置”功能生成配置文件后，通过AirDrop或iCloud同步至其他设备并执行“导入配置”，所有节点的认证参数即可在所有设备上保持完全一致。如果手动在每台设备上输入配置，建议先在一台设备上完成配置并测试通过后，再逐一在其他设备上输入完全相同的参数，避免因输入错误导致部分设备连接失败而其他设备正常工作的混乱局面。
常见问题FAQ
uuid在Shadowrocket中到底填在哪个框？
uuid在VMess节点的编辑页面中直接填写在标记为“密码”的输入框内，这是Shadowrocket为统一界面设计所做的字段复用处理，并非开发者遗漏了uuid字段。用户只需将服务商提供的36位uuid字符串完整复制粘贴至“密码”框中即可，无需寻找名为uuid的独立输入项。如果该框内已有内容，直接覆盖填写，保存后生效。
alterId是必须填的吗？不填会怎样？
alterId在绝大多数VMess节点配置中是必须填写的参数，其值由服务端指定，客户端不填或填写错误将导致连接失败。如果服务商未明确提供alterId数值，通常可尝试填写0，因为这是现代VMess实现的默认值。若填写0后连接仍失败，则需联系服务商确认具体的alterId配置值，不同服务商的设定可能不同。
导入订阅后为什么看不到alterId填在哪里？
导入订阅后的节点，alterId在节点编辑界面的传输层设置中自动填充并隐藏于“额外参数”区域，用户不需要手动查看或修改该字段。Shadowrocket的订阅解析机制会识别订阅内容中的alterId值并自动配置，用户正常使用节点时无需进入传输层设置验证该参数。如遇连接故障需要排查alterId，可进入传输层设置页面查看该字段的实际数值。
VMess的uuid和alterId与SS的密码有什么区别？
SS协议中的密码是单一字符串，用于对称加密的密钥派生，而VMess的uuid是一个符合UUID标准的全局唯一标识符，用于客户端与服务端之间的身份认证和会话管理，两者作用完全不同。alterId则是VMess独有的动态混淆参数，在SS协议中不存在对应概念。用户在切换协议类型时，应清空原协议下的不相关字段，避免将SS的密码误填入VMess的uuid位置而导致认证失败。