Sublink-Worker项目中Base64编码异常的解决方案

在Sublink-Worker项目中，当处理包含非拉丁字符的vless链接时，系统可能会抛出"btoa() can only operate on characters in the Latin1 (ISO/IEC 8859-1) range"错误。这个问题源于JavaScript内置的btoa()函数对字符编码的限制。

问题背景

JavaScript原生的btoa()和atob()函数只能正确处理Latin1字符集中的字符。当遇到中文字符、emoji或其他Unicode字符时，这些函数就会抛出异常。在Sublink-Worker项目中，当vless链接包含中文节点名称或其他特殊字符时，就会触发这个错误。

解决方案

为了解决这个问题，我们可以实现一套自定义的Base64编解码方案，它能够正确处理所有Unicode字符。解决方案包含以下几个关键函数：

1. encodeBase64：将任意Unicode字符串编码为Base64
2. decodeBase64：将Base64字符串解码回原始Unicode字符串
3. base64FromBinary：底层实现，将二进制字符串转换为Base64
4. base64ToBinary：底层实现，将Base64转换回二进制字符串

这套方案的核心思路是：

• 首先使用TextEncoder将Unicode字符串转换为UTF-8字节数组
• 然后将字节数组转换为二进制字符串
• 最后实现自定义的Base64编码算法处理这些二进制数据

技术实现细节

编码过程

1. 使用TextEncoder将输入字符串编码为UTF-8字节数组
2. 将字节数组转换为二进制字符串
3. 对二进制字符串进行Base64编码：
   • 每3个字节为一组进行处理
   • 将24位数据分割为4个6位索引
   • 使用Base64字符表将索引转换为对应字符
   • 处理不足3字节的尾部数据，添加适当的填充字符"="

解码过程

1. 移除Base64字符串末尾的填充字符"="
2. 每4个字符为一组进行处理
3. 将每组Base64字符转换回6位索引
4. 将4个6位索引重新组合为3个8位字节
5. 使用TextDecoder将字节数组解码回原始字符串

优势与改进

相比原生方案，这个自定义实现具有以下优势：

1. 完整支持Unicode字符集，包括中文、emoji等
2. 不依赖浏览器原生函数，兼容性更好
3. 实现透明，便于调试和扩展
4. 性能经过优化，处理大文本时效率较高

实际应用

在Sublink-Worker项目中，这套方案已经成功解决了vless链接解析时的编码问题。无论是包含中文节点名称的链接，还是其他特殊字符的配置，现在都能被正确解析和处理。

这个解决方案不仅适用于当前项目，也可以作为通用的Base64编解码方案应用于其他需要处理Unicode字符串的JavaScript项目中。