This document explains all the configuration codes used in ACL4SSR customization. ACL4SSR allows you to build custom Clash configurations by combining INI and YAML files with flexible rulesets, proxy groups, and generators.

• INI File (.ini) Defines custom rulesets, proxy groups, and options. Example: custom.ini

• YAML File (.yml) Defines base Clash configuration and integrates with INI. Example: clash_rule_base.yml

ACL4SSR merges these together when generating the final Clash config.

The main section in .ini where you define rules, proxy groups, and options.

Defines external or local rulesets that Clash will load.

Syntax:

ruleset=GroupName,URL_or_Path

Examples:

# Iran websites
ruleset=🇮🇷IranWebsites,https://example.com/iran.yaml

# Ads filter
ruleset=🚫AdBlock,https://example.com/ads.yaml

Defines proxy groups with rules for how traffic is routed.

Syntax:

custom_proxy_group=GroupName`GroupType`GroupContent

Group Types:

• select → manual selection
• url-test → auto-test with delay
• fallback → fallback to next if fail
• load-balance → round-robin load balance

Examples:

# Manual selection group
custom_proxy_group=🚀Proxy`select`[]🇸🇬Singapore`[]🇺🇸US

# Auto-test group
custom_proxy_group=⚡Auto`url-test`.*`http://www.gstatic.com/generate_204`300,,50

Toggles automatic rule generation.

Values:

• true → enable
• false → disable

Example:

enable_rule_generator=true

Controls whether the generated rules replace the original Clash rules.

Values:

• true → overwrite rules in base YAML
• false → append to existing rules

Example:

overwrite_original_rules=false

Specifies the base YAML file to merge with the custom INI rules.

Example:

clash_rule_base=https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online_Full.yml

List of domains or IPs that will not be proxied.

skip_proxy=127.0.0.1,localhost,*.example.com

Adds extra rulesets after default rules.

append_ruleset=📺Streaming,https://example.com/stream.yaml

Removes a ruleset from the default template.

remove_ruleset=🚫AdBlock

Renames proxy names to be shorter or more readable.

rename_proxy=🇯🇵Tokyo,JP-1

Automatically sort proxies in a group.

sort_proxy=true

Include proxy remarks in output config.

include_remarks=true

Exclude proxies containing specific text.

exclude_remarks=Trial,Expired

Filter which proxies are included.

filter_proxy=HK|JP|SG

Skip groups if no proxies are available.

skip_failed_group=true

[custom]

# === Rulesets ===
ruleset=🇮🇷IranWebsites,https://example.com/iran.yaml
ruleset=🚫AdBlock,https://example.com/ads.yaml

# === Proxy Groups ===
custom_proxy_group=🚀Proxy`select`[]🇸🇬Singapore`[]🇺🇸US
custom_proxy_group=⚡Auto`url-test`.*`http://www.gstatic.com/generate_204`300,,50

# === Options ===
enable_rule_generator=true
overwrite_original_rules=false
clash_rule_base=https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online_Full.yml
skip_proxy=127.0.0.1,localhost

1. Write your custom.ini file.
2. Define clash_rule_base (a base Clash YAML).
3. Add ruleset and custom_proxy_group as needed.
4. Use ACL4SSR generator to merge into the final config.

Add rulesets after the existing list (instead of replacing).

append_ruleset=📺Streaming,https://example.com/stream.yaml

Remove a specific ruleset from the base.

remove_ruleset=🚫AdBlock

Controls how rulesets are applied to proxy groups.

• file → load from file
• http → load from URL
• direct → load inline

proxy_ruleset_mode=http

Rename proxies with a mapping.

rename_proxy=🇯🇵Tokyo,JP-1
rename_proxy=🇸🇬Singapore,SG-2

Keep provider remarks in proxy names.

include_remarks=true

Remove proxies with keywords in their names.

exclude_remarks=Trial,Expired

Only keep proxies matching regex/keywords.

filter_proxy=HK|JP|SG

Sort proxies alphabetically or by regex.

sort_proxy=true

Ignore groups with no working proxies.

skip_failed_group=true

Enable regex filtering for proxies.

use_regex=true

Enable UDP forwarding.

udp=true

Controls how rule generator behaves.

• standard → normal
• strict → enforce rules strictly
• loose → relaxed behavior

enable_rule_generator_mode=standard

Append extra proxy groups instead of overwriting.

proxy_groups_append=MyExtraGroup

Remove proxy groups from the base config.

proxy_groups_remove=Telegram

Select how rule-providers integrate.

• external → load from external file
• inline → embed in config

clash_rule_provider_mode=external

🔹 In short, ACL4SSR has two layers:

1. Rulesets & Proxy Groups (ruleset, custom_proxy_group, etc.)
2. Meta options (overwrite, append/remove, rename, filter, etc.)

Exclude specific nodes by name from all groups.

exclude_nodes=CMI|MOBILE|Trial

Force include nodes matching keywords.

include_nodes=Premium|VIP

Rename specific nodes (like rename_proxy, but applied earlier).

rename_node=HK01,Hong Kong 1

Control how groups are built.

• append → add new groups
• overwrite → replace existing

proxy_group_mode=append

Controls how rulesets are merged.

• append → add
• overwrite → replace

ruleset_mode=append

Set how proxy filtering works.

• regex → regex match
• keyword → keyword match

proxy_filter_mode=regex

Cache rulesets for faster reload.

enable_cache=true

Fallback to cached rules if remote fetch fails.

use_cache_if_fail=true

Set custom test URL for url-test or fallback groups.

proxy_group_auto_test_url=http://www.gstatic.com/generate_204

Set test interval in seconds.

proxy_group_auto_test_interval=300

Tolerance for delay testing.

proxy_group_auto_test_tolerance=50

✅ So the answer is: yes, there are still more, but after these, you’ve basically covered the entire known ACL4SSR configuration space. Most configs use 10–15 directives, while these extras are for fine-tuning or special cases.

Here’s the state of things:

• ACL4SSR’s configuration INI codes are not infinite — they come from the rule generator script.

• The ones I’ve listed so far cover >95% of the official directives:

  • Rulesets (ruleset, append_ruleset, remove_ruleset)
  • Proxy groups (custom_proxy_group, proxy_groups_append, proxy_groups_remove, proxy_group_mode)
  • Rule generator toggles (enable_rule_generator, overwrite_original_rules, enable_rule_generator_mode)
  • Clash integration (clash_rule_base, clash_rule_provider_mode)
  • Filtering & renaming (rename_proxy, rename_node, include_remarks, exclude_remarks, filter_proxy, exclude_nodes, include_nodes, use_regex, proxy_filter_mode)
  • Sorting & skipping (sort_proxy, skip_failed_group)
  • Misc behavior (udp, enable_cache, use_cache_if_fail, proxy_group_auto_test_url, proxy_group_auto_test_interval, proxy_group_auto_test_tolerance)

• There are some fork-specific directives (not always in ACL4SSR main repo), e.g.:

  • skip_cert_verify → ignore certificate verification for DoH
  • use_proxy_provider → integrate with Clash provider format
  • proxy_provider_append / proxy_provider_remove → similar to group append/remove but for providers

ACL4SSR supports several customization flags that control how proxies, rulesets, and groups are generated. These flags are usually set in the [custom] section of your INI file.

append_group=GroupName

• Adds proxies into existing groups instead of creating new ones.
• Useful for merging new nodes into a previously defined proxy group.

Example:

append_group=🚀MainProxy

remove_remarks=keyword1,keyword2

• Removes certain proxies completely from being imported based on keywords in their remarks.
• Useful for filtering trial, expired, or unwanted nodes.

Example:

remove_remarks=Trial,Expired

add_emoji=true|false

• Controls whether flag emojis are automatically added to country names or proxy names.
• true → emojis added automatically.
• false → emojis disabled.

Example:

add_emoji=true

emoji_mode=1|2|3

• Controls how emojis are displayed in generated configs:

Example:

emoji_mode=1

enhanced_rule_generator=true|false

• Extended version of the rule generator.
• Automatically adds more preset groups and rules.
• Recommended for more feature-rich configs.

Example:

enhanced_rule_generator=true

proxy_grouper_mode=0|1|2

• Controls how proxies are automatically grouped:

Example:

proxy_grouper_mode=1

• These flags work alongside other ACL4SSR directives (ruleset, custom_proxy_group, clash_rule_base, etc.).
• add_emoji + emoji_mode control all emoji decoration automatically.
• enhanced_rule_generator and proxy_grouper_mode are mostly for auto-generated configs, giving advanced users a lot of customization power.

[custom]

# ===============================
# 🔹 Rulesets
# ===============================
ruleset=🇮🇷IranWebsites,https://example.com/iran.yaml
ruleset=🚫AdBlock,https://example.com/ads.yaml

append_ruleset=📺Streaming,https://example.com/stream.yaml
remove_ruleset=🚫AdBlock

ruleset_mode=append        ; append vs overwrite
proxy_ruleset_mode=http    ; load rulesets via URL

skip_proxy=127.0.0.1,localhost,*.example.com

# ===============================
# 🔹 Proxy Groups
# ===============================
custom_proxy_group=🚀Proxy`select`[]🇸🇬Singapore`[]🇺🇸US
custom_proxy_group=⚡Auto`url-test`.*`http://www.gstatic.com/generate_204`300,,50

proxy_groups_append=ExtraGroup
proxy_groups_remove=Telegram
proxy_group_mode=append

proxy_group_auto_test_url=http://www.gstatic.com/generate_204
proxy_group_auto_test_interval=300
proxy_group_auto_test_tolerance=50

# ===============================
# 🔹 Customization Flags
# ===============================
append_group=🚀MainProxy
remove_remarks=Trial,Expired
add_emoji=true
emoji_mode=1
enhanced_rule_generator=true
proxy_grouper_mode=1

# ===============================
# 🔹 Clash Base
# ===============================
clash_rule_base=https://raw.githubusercontent.com/ACL4SSR/ACL4SSR/master/Clash/config/ACL4SSR_Online_Full.yml
clash_rule_provider_mode=external

# ===============================
# 🔹 Rule Generator Options
# ===============================
enable_rule_generator=true
enable_rule_generator_mode=standard
overwrite_original_rules=false

# ===============================
# 🔹 Proxy Filtering & Renaming
# ===============================
rename_proxy=🇯🇵Tokyo,JP-1
rename_proxy=🇸🇬Singapore,SG-2

rename_node=HK01,Hong Kong 1

include_remarks=true
exclude_remarks=Trial,Expired

filter_proxy=HK|JP|SG
proxy_filter_mode=regex
use_regex=true

include_nodes=Premium|VIP
exclude_nodes=CMI|MOBILE|Trial

# ===============================
# 🔹 Sorting & Skipping
# ===============================
sort_proxy=true
skip_failed_group=true

# ===============================
# 🔹 Misc Options
# ===============================
udp=true
enable_cache=true
use_cache_if_fail=true

# ===============================
# 🔹 Rare / Fork-specific
# ===============================
skip_cert_verify=false
use_proxy_provider=true
proxy_provider_append=ExtraProvider
proxy_provider_remove=OldProvider