Table of Contents
- Linux
- Windows. Please refer to Windows README
- Those with a certain understanding of Clash configurations.
- Fans of TUI software.
For example: ArchLinux.
# ## Install mihomo
paru -S mihomo
# ## Add mihomo hook
# cat /etc/pacman.d/hooks/mihomo.hook (If there is no system similar to hook, use ClashSrvCtl Tab's SetPermission or use mihomo@root service)
[Trigger]
Operation = Install
Operation = Upgrade
Type = Path
Target = usr/bin/mihomo
[Action]
When = PostTransaction
Exec = /usr/bin/setcap 'cap_net_admin,cap_net_bind_service=+ep' /usr/bin/mihomo
# ## Edit mihomo service unit
# systemctl edit mihomo
[Service]
# Remove original ExecStart
ExecStart=
ExecStart=/usr/bin/mihomo -d /srv/mihomo -f /srv/mihomo/config.yaml
# ## Create /srv/mihomo
mkdir /srv/mihomo
cd /srv/mihomo
chown -R mihomo:mihomo /srv/mihomo
usermod -a -G mihomo <user>
groups <user> # Check if already added to mihomo group
# Optional. After version 0.2.0, clashtui will automatically fix file permissions.
chmod g+w /srv/mihomo # clashtui needs permission to create files.
chmod g+s /srv/mihomo # Make the group of files created by clashtui mihomo. This is to give clashtui group read and write permissions to files in this directory.
chmod g+w /srv/mihomo/config.yaml # clashtui needs write permission.
# ## Set mihomo service unit
systemctl enable mihomo # Start on boot
systemctl restart mihomo # Start serviceIt is recommended to test the mihomo service with a valid configuration to ensure its success. Check if meta-rules-dat file is missing.
mihomo.service of mihomo package:
[Unit]
Description=Mihomo daemon
After=network.target NetworkManager.service systemd-networkd.service iwd.service
[Service]
Type=simple
User=mihomo
Group=mihomo
LimitNPROC=500
LimitNOFILE=1000000
CapabilityBoundingSet=CAP_NET_ADMIN CAP_NET_RAW CAP_NET_BIND_SERVICE
AmbientCapabilities=CAP_NET_ADMIN CAP_NET_RAW CAP_NET_BIND_SERVICE
Restart=always
RestartSec=5
ExecStart=/usr/bin/mihomo -d /etc/mihomo
[Install]
WantedBy=multi-user.target
For example: ArchLinux
# ## Install clashtui
# There is a latest [PKGBUILD](./PkgManagers/PKGBUILD).
paru -S clashtui. # For other Linux distributions, manually download and place clashtui in PATH.
# ## Configure clashtui
clashtui # Running this will generate some default files in ~/.config/clashtui.
# nvim ~/.config/clashtui/config.yaml
# The following parameters correspond to the command <clash_core_path> -d <clash_cfg_dir> -f <clash_cfg_path>
clash_core_path: "/usr/bin/mihomo"
clash_cfg_dir: "/srv/mihomo"
clash_cfg_path: "/srv/mihomo/config.yaml"
clash_srv_name: "mihomo" # systemctl {restart | stop} <clash_srv_name>
clash_srv_is_user: false # true: systemctl --user ...The subsequent versions of clashtui have not been uploaded to crates.io because clashtui is now separated into multiple modules. If uploaded to crates.io, it would require uploading each dependent module, and some modules do not need to be uploaded to crates.io. See ref. So, do not use cargo install clashtui for installation.
Configure ~/.config/clashtui/basic_clash_config.yaml manually. Some basic fields in this file will be merged into clash_cfg_path. Refer to here for configuring tun mode.
Create a folder named data in the directory where clashtui program resides. Then the data will be placed in data instead of ~/.config/clashtui.
Press ? to display help.
- Import profile: In the
Profilearea, pressito input Name (preferably without suffix) and Uri (url or file path). - Update profile: Press
ato update all resources dependent on the Profile. By default, it uses its own proxy for updates. If tun mode or system proxy is enabled and there are no available nodes, stop the mihomo service first (ClashSrvCtl Tab's StopClashService), then update. - Select profile: Press
Enterto select the Profile. - Open mihomo ui: Enter
http://127.0.0.1:9090/uiin the browser. Provided your mihomo configuration has already set up ui related fields, reference.
If it is the first time installing clashtui:
- If you have changed the
basic_clash_configor other configurations, restart clashtui to reparse the changes inbasic_clash_config, etc. - Import a profile that does not require updating with a proxy.
- Press
ato update all resources dependent on the profile. - Press
Enterto select this profile, merging the fields ofbasic_clash_configintoclash_cfg_path. - Restart the mihomo service (StartClashService in ClashSrvCtl Tab).
clashtui -u # Updates all profiles in command-line mode. If the profile has proxy-providers, they will also be updated.Thus, you can use cronie to schedule updates:
# crontab -e
0 10,14,16,22 * * * /usr/bin/env clashtui -u >> ~/cron.out 2>&1For cronie usage, see ref.
-
Press
tto switch to Templates area. -
Select
template_proxy_providers, presseto edit, and enter subscription links.For example:
https://.... https://.... # Supports comments #https://.... -
Press
Enterto generate configuration toProfile. Presspto switch back toProfile, thenEnterto select the configuration.
The latest templates can be found here.
Configure in ~/.config/clashtui/config.yaml. %s will be automatically replaced with the path of the selected file.
For example:
edit_cmd: "alacritty -e nvim %s"
opendir_cmd: "alacritty -e ranger %s"The template feature is unique to clashtui. Refer to provided example templates for specific usage rules.
Define reusable fields:
proxy-anchor:
- delay_test: &pa_dt {url: https://www.gstatic.com/generate_204, interval: 300}
- proxy_provider: &pa_pp {interval: 3600, intehealth-check: {enable: true, url: https://www.gstatic.com/generate_204, interval: 300}}Generate a proxy-provider for each link in template_proxy_providers:
proxy-providers:
provider:
tpl_param:
type: http # type field must be placed here, not within pa_pp. This is because clashtui detects if it is a network resource based on this field.
<<: *pa_ppGenerate a Select, Auto proxy-group for each proxy-providers:
proxy-groups:
- name: "Select"
tpl_param:
providers: ["provider"]
type: select
- name: "Auto"
tpl_param:
providers: ["provider"]
type: url-test
<<: *pa_dtUse Select, Auto proxy-groups:
proxy-groups:
- name: "Entry"
type: select
proxies:
- <Auto>
- <Select>- basic_clash_config.yaml: Basic fields of mihomo configuration, which will be merged into
clash_cfg_path. - config.yaml: Configuration of clashtui.
This project is for learning and reference purposes only. The author does not guarantee the accuracy, completeness, or applicability of the code in the project. Users should use the code in this project at their own risk.
The author is not responsible for any direct or indirect losses caused by the use of the code in this project, including but not limited to data loss, computer damage, and business interruption.
Before using the code in this project, users should fully understand its functionality and potential risks, and seek professional advice if necessary. The author is not liable for any consequences resulting from the use of the code in this project.
When using the code in this project, please comply with relevant laws and regulations, and refrain from using it for illegal activities or activities that infringe upon the rights of others.
The author reserves the right of final interpretation of this disclaimer, and may modify and update it at any time.
![@dependabot[bot]](https://avatars.githubusercontent.com/in/29110?s=64&v=4){kind=small}