#Mac #Release

Version 5.5.0-2588

#### Module
- Added several new official modules; official modules can now be dynamically updated.
- Modules have a new classification field for convenient access and categorization in the UI.
- Modules now accept parameter tables, supporting multiple parameters. Parameters will be used to modify module content through text replacement.

#### Script
- New script execution engine. Optimized execution performance and memory usage.
- $httpClient has added several practical parameters.
For more details on the updates above, see the documentation.

#### Enhancements
- New parameter: always-raw-tcp-keywords. For usage, refer to documentation.
- Added SRC-PORT rule for matching client port numbers.
- IN-PORT/SRC-PORT/DEST-PORT three rules are categorized as port number rule types, supporting three kinds of expressions:
- Directly writing the port number, such as IN-PORT,6153
- Port number closed interval: such as DEST-PORT,10000-20000
- Using >, <, <=, >= operators, such as SRC-PORT,>=50000
- The UI can now maintain pure empty lines from original configurations after editing.

### Fixes
- Corrected a detail issue with QUIC flow control and optimized latency performance for Ponte/TUIC/Hysteria2 protocols.
- Other bug fixes.

#Mac #Beta

Version 5.5.0-2589

#### Module
- Added several new official modules; official modules can now be dynamically updated.
- Modules have a new classification field for convenient access and categorization in the UI.
- Modules now accept parameter tables, supporting multiple parameters. Parameters will be used to modify module content through text replacement.

#### Script
- New script execution engine. Optimized execution performance and memory usage.
- $httpClient has added several practical parameters.
For more details on the updates above, see the documentation.

#### Enhancements
- New parameter: always-raw-tcp-keywords. For usage, refer to documentation.
- Added SRC-PORT rule for matching client port numbers.
- IN-PORT/SRC-PORT/DEST-PORT three rules are categorized as port number rule types, supporting three kinds of expressions:
- Directly writing the port number, such as IN-PORT,6153
- Port number closed interval: such as DEST-PORT,10000-20000
- Using >, <, <=, >= operators, such as SRC-PORT,>=50000
- The UI can now maintain pure empty lines from original configurations after editing.

### Fixes
- Corrected a detail issue with QUIC flow control and optimized latency performance for Ponte/TUIC/Hysteria2 protocols.
- Other bug fixes.

#Mac #Release

Version 5.5.0-2589

#### Module
- Added several new official modules; official modules can now be dynamically updated.
- Modules have a new classification field for convenient access and categorization in the UI.
- Modules now accept parameter tables, supporting multiple parameters. Parameters will be used to modify module content through text replacement.

#### Script
- New script execution engine. Optimized execution performance and memory usage.
- $httpClient has added several practical parameters.
For more details on the updates above, see the documentation.

#### Enhancements
- New parameter: always-raw-tcp-keywords. For usage, refer to documentation.
- Added SRC-PORT rule for matching client port numbers.
- IN-PORT/SRC-PORT/DEST-PORT three rules are categorized as port number rule types, supporting three kinds of expressions:
- Directly writing the port number, such as IN-PORT,6153
- Port number closed interval: such as DEST-PORT,10000-20000
- Using >, <, <=, >= operators, such as SRC-PORT,>=50000
- The UI can now maintain pure empty lines from original configurations after editing.

### Fixes
- Corrected a detail issue with QUIC flow control and optimized latency performance for Ponte/TUIC/Hysteria2 protocols.
- Other bug fixes.

#iOS #TestFlight

Surge 5 5.21.0 (3063) is ready to test on iOS.

What to Test:

- 新增 URL scheme: surge:///install-module?url=…，url 参数需经过 URI encode
- 在配置了 encrypted-dns-follow-outbound-mode=true 参数时，如果 DoH/DoQ/DoH3 连接匹配了一个使用域名的代理服务器，若该代理服务器的域名存在 DNS Local Mapping 记录，且该记录包含一个 IP 地址或传统 DNS 服务器，则可允许通过该代理服务器进行查询。
（再次提示，通过代理服务器进行 DNS 查询会破坏 CDN 的优化，导致载入图片和视频时出现严重缓慢。除非有非常特殊的需求并没有必要进行这样的配置，应使用域名规则保证请求直接由代理服务器进行DNS查询）
- 优化了请求记录，现在将显示匹配到的 URL Rewrite 和 Header Rewrite 的具体规则
- 调整了 DNS 引擎处理空结果的逻辑，现在在配置了多个 DNS 服务器的时候，也不再等待所有服务器响应空结果，以避免在 AAAA 记录不存在时产生额外等待。（但由于实际环境中各地的 DNS 服务器的行为可能不同，需观察此改动是否会造成副作用，如果出现了导致解析异常的问题请反馈）

#Mac #Beta

Version 5.5.1-2590


- When the parameter encrypted-dns-follow-outbound-mode=true is configured, if a DoH/DoQ/DoH3 connection matches a proxy server using a domain name, and if there is a DNS Local Mapping record for that proxy server's domain name containing an IP address or traditional DNS server, then it is permissible to query through that proxy server. (Querying DNS through a proxy server will break CDN optimization, leading to severe slowness when loading images and videos. Unless there are very special requirements and it is not necessary to configure in this way, domain rules should be used to ensure requests are directly queried by the proxy server.)
- Optimized request logging. Now the specific rules matched for URL Rewrite and Header Rewrite will be displayed.
- Adjusted the logic of how the DNS engine handles empty results. Now when multiple DNS servers are configured, it no longer waits for all servers to respond with empty results in order to avoid additional waiting when AAAA records do not exist. (However, since the behavior of DNS servers may vary in different environments, observe whether this change causes side effects; please provide feedback if issues arise causing abnormal results.)

#Mac #Beta

Version 5.5.1-2591


- When the parameter encrypted-dns-follow-outbound-mode=true is configured, if a DoH/DoQ/DoH3 connection matches a proxy server using a domain name, and if there is a DNS Local Mapping record for that proxy server's domain name containing an IP address or traditional DNS server, then it is permissible to query through that proxy server. (Querying DNS through a proxy server will break CDN optimization, leading to severe slowness when loading images and videos. Unless there are very special requirements and it is not necessary to configure in this way, domain rules should be used to ensure requests are directly queried by the proxy server.)
- Optimized request logging. Now the specific rules matched for URL Rewrite and Header Rewrite will be displayed.
- Adjusted the logic of how the DNS engine handles empty results. Now when multiple DNS servers are configured, it no longer waits for all servers to respond with empty results in order to avoid additional waiting when AAAA records do not exist. (However, since the behavior of DNS servers may vary in different environments, observe whether this change causes side effects; please provide feedback if issues arise causing abnormal results.)

#iOS #TestFlight

Surge 5 5.21.0 (3064) is ready to test on iOS.

What to Test:

- 修正上个版本中产生的使用 Header rewrite 规则会崩溃的问题

#Mac #Beta

Version 5.5.1-2592

- Mock (Map Local) feature fully enhanced.
- Added data types such as text, tiny-gif, base64 for inline direct data return.
- Added status-code parameter
- UI related configurations have not been updated yet. For usage methods, see the documentation: https://manual.nssurge.com/http-processing/mock.html
- When the parameter encrypted-dns-follow-outbound-mode=true is configured, if a DoH/DoQ/DoH3 connection matches a proxy server using a domain name, and if there is a DNS Local Mapping record for that proxy server's domain name containing an IP address or traditional DNS server, then it is permissible to query through that proxy server. (Querying DNS through a proxy server will break CDN optimization, leading to severe slowness when loading images and videos. Unless there are very special requirements and it is not necessary to configure in this way, domain rules should be used to ensure requests are directly queried by the proxy server.)
- Optimized request logging. Now the specific rules matched for URL Rewrite and Header Rewrite will be displayed.
- Adjusted the logic of how the DNS engine handles empty results. Now when multiple DNS servers are configured, it no longer waits for all servers to respond with empty results in order to avoid additional waiting when AAAA records do not exist. (However, since the behavior of DNS servers may vary in different environments, observe whether this change causes side effects; please provide feedback if issues arise causing abnormal results.)

#iOS #TestFlight

Surge 5 5.21.0 (3066) is ready to test on iOS.

What to Test:

Mock (Map Local) 功能全面强化
- 新增 text, tiny-gif, base64 等数据类型，以便于 inline 直接返回数据
- 新增 status-code 参数
UI 相关配置暂未更新，使用方式详见文档说明：https://manual.nssurge.com/http-processing/mock.html

#iOS #TestFlight

Surge 5 5.21.0 (3067) is ready to test on iOS.

What to Test:

- 修正配置解析时对一些特定语法的处理问题
- 优化外置资源页面
- 引入新的外置资源后，自动弹出外置资源页面时将只下载需要更新的资源
- 在审查模块修改后的配置时，会对由模块加入的配置行加上模块名的注释（仅限部分 section）

#Mac #Beta

Version 5.5.1-2593

- Mock (Map Local) feature fully enhanced.
- Added data types such as text, tiny-gif, base64 for inline direct data return.
- Added status-code parameter
- UI related configurations have not been updated yet. For usage methods, see the documentation: https://manual.nssurge.com/http-processing/mock.html
- When the parameter encrypted-dns-follow-outbound-mode=true is configured, if a DoH/DoQ/DoH3 connection matches a proxy server using a domain name, and if there is a DNS Local Mapping record for that proxy server's domain name containing an IP address or traditional DNS server, then it is permissible to query through that proxy server. (Querying DNS through a proxy server will break CDN optimization, leading to severe slowness when loading images and videos. Unless there are very special requirements and it is not necessary to configure in this way, domain rules should be used to ensure requests are directly queried by the proxy server.)
- Optimized request logging. Now the specific rules matched for URL Rewrite and Header Rewrite will be displayed.
- Adjusted the logic of how the DNS engine handles empty results. Now when multiple DNS servers are configured, it no longer waits for all servers to respond with empty results in order to avoid additional waiting when AAAA records do not exist. (However, since the behavior of DNS servers may vary in different environments, observe whether this change causes side effects; please provide feedback if issues arise causing abnormal results.)

#iOS #TestFlight

Surge 5 5.21.0 (3068) is ready to test on iOS.

What to Test:

- 请求列表过滤器优化，现在将把过滤器显示于顶部，并快速切换过滤器是否启用。
- 长按过滤器项目可以显示菜单，可删除或反转该项目为负过滤器。
- 过滤器项目将持久化存在
- 优化脚本引擎，限制 JSC 引擎并发处理数为 2 以避免内存问题
- 修正外部资源页面未能正确显示更新失败的错误提示的问题
- 外部资源页面现在可以查看 URL 资源的具体内容了

#iOS #TestFlight #订阅功能

Surge 5 5.21.0 (3069) is ready to test on iOS.

What to Test:

- 新的订阅功能：Always Capture
可为规则配置参数 always-capture，使得匹配到该规则的请求，可以无视 HTTP Capture 开关状态，直接永久保存并截取 Body。如
DOMAIN,example.com,DIRECT,always-capture=Debug
其中的参数名为存入的 Session 的名称，与 HTTP Capture 开关的行为不同，使用该参数截取的请求，将总是写入同一个 Session 中。可以在已保存的截取会话列表中查看。
（尚不可通过 UI 进行配置）

- 增强了 HTTP Body 解压时的兼容性
- 修正了在使用覆盖策略组后，显示策略组的延迟依然是覆盖前的选项的结果
- 修正在 iPad 上长按过滤器会导致崩溃的问题

#iOS #TestFlight

Surge 5 5.21.0 (3070) is ready to test on iOS.

What to Test:

- 在因内存占用问题无法开启时，给出更详细的资源使用提示。也可以在配置列表页长按菜单中查看。

#Mac #Beta

Version 5.5.1-2594

- Mock (Map Local) feature fully enhanced.
- Added data types such as text, tiny-gif, base64 for inline direct data return.
- Added status-code parameter
- UI related configurations have not been updated yet. For usage methods, see the documentation: https://manual.nssurge.com/http-processing/mock.html
- When the parameter encrypted-dns-follow-outbound-mode=true is configured, if a DoH/DoQ/DoH3 connection matches a proxy server using a domain name, and if there is a DNS Local Mapping record for that proxy server's domain name containing an IP address or traditional DNS server, then it is permissible to query through that proxy server. (Querying DNS through a proxy server will break CDN optimization, leading to severe slowness when loading images and videos. Unless there are very special requirements and it is not necessary to configure in this way, domain rules should be used to ensure requests are directly queried by the proxy server.)
- Optimized request logging. Now the specific rules matched for URL Rewrite and Header Rewrite will be displayed.
- Adjusted the logic of how the DNS engine handles empty results. Now when multiple DNS servers are configured, it no longer waits for all servers to respond with empty results in order to avoid additional waiting when AAAA records do not exist. (However, since the behavior of DNS servers may vary in different environments, observe whether this change causes side effects; please provide feedback if issues arise causing abnormal results.)

#iOS #TestFlight #订阅功能

Surge 5 5.21.0 (3071) is ready to test on iOS.

What to Test:

新的订阅功能：Body Rewrite
- 详见文档说明：https://manual.nssurge.com/http-processing/body-rewrite.html
- 各项 rewrite 与脚本处理间的顺序可见：https://manual.nssurge.com/http-processing.html

- 新增对 STUN 数据包的识别，可用 PROTOCOL,STUN 进行匹配。（正常情况下没有必要进行特殊处理，如果进行 REJECT 会导致部分应用不正常。关于导致 IP 泄漏的问题和 STUN 本身并无直接的联系，详见：https://community.nssurge.com/d/2233-ip）
- 与 QUIC 类似，为保证兼容性，PROTOCOL,UDP 同样也可以继续匹配 STUN 流量
- 模块新增 #!requirement= 描述，允许更加复杂的使用条件限制。如模块用到了新加入的 Body Rewrite 功能，则需要 Surge 核心的配置版本进行限制（当前的版本号为20）。
#!requirement=CORE_VERSION>
同时支持类 SQL 的表达式，如 CORE_VERSION> && (SYSTEM = 'iOS' || SYSTEM = 'tvOS')。详细用法将会在后续给出。
- 脚本编辑器不再可以选择来自模块的脚本进行编辑
- 修正因模块配置而产生的警告信息不会显示的问题

#iOS #TestFlight

Surge 5 5.21.0 (3072) is ready to test on iOS.

What to Test:

- 脚本编辑器细节优化
- 新增 mock 执行模式的引擎选项。
- 可加载和保存来自模块的本地脚本文件，不再可以从此处选择来自 URL 的脚本文件
- 模块管理页面优化
- 修改分类时可从已存在分类中直接选择
- 可单独查看某个模块所使用的外部资源
- 审查模块内容时，自动移除无效空行
- 在外部资源页面查看脚本时，将使用脚本编辑器打开

#iOS #TestFlight

Surge 5 5.21.0 (3075) is ready to test on iOS.

What to Test:

- 新增 Utilites 标签页的长按快捷菜单
- 修正外部资源页面的内容乱序的问题
- 配置 Shortcuts 执行 Surge 脚本时可直接读取当前配置的脚本列表
- 修正在脚本中传入一些错误类型的参数会导致 Surge 崩溃的问题
- 其他细节调整和修正

#iOS #TestFlight

Surge 5 5.21.0 (3078) is ready to test on iOS.

What to Test:

- 修正有时通过外部资源列表查看脚本时脚本无法载入的问题
- 脚本编辑器可以直接载入来自 URL 的脚本
- GeoIP 数据库由主应用更新后不再需要重启即可生效
- 模块页面允许撤销修改以避免误操作导致生效顺序修改
- 其他细节调整

#iOS #TestFlight

Surge 5 5.21.0 (3079) is ready to test on iOS.

What to Test:

- 支持 Body Rewrite 的 UI 配置
- Mock 的新数据类型支持 UI 配置
- 其他细节调整

#iOS #TestFlight

Surge 5 5.21.0 (3080) is ready to test on iOS.

What to Test:

- 修正 Body Rewrite 规则无法正确保存的问题
- 其他细节修正