Frequently Asked Questions

Frequently Asked Questions

This post contains frequently asked questions about Clash Nyanpasu. Please check here first if you have any questions.

Application

1. macOS prompts that “Clash Nyanpasu” is damaged and can’t be opened

Open Terminal and execute:

sudo xattr -r -d com.apple.quarantine /Applications/Clash\ Nyanpasu.app

2. Where is the Clash Nyanpasu config/logs directory?

There are currently two ways to open it directly:

• Right click on the tray icon and select Open Dir - Config Dir. You can open the configuration directory.

• In the main program interface, navigate to the Settings page, find the Config Dir and click the button to open the configuration directory.

The same can be done for the log directory.

Tips

In case you cannot access the tray and cannot get to the main program interface, we can open it by entering the path directly.

Starting with v1.6.0, Clash Nyanpasu split the installation directory into configuration and data directories, the log directory was moved to the data directory, and Windows users can choose to migrate the configuration directory.

• For Windows, the default configuration directory is located at %APPDATA%/Clash Nyanpasu/config and the data directory is located at %LOCALAPPDATA%/Clash Nyanpasu/data.

  • If you customize the configuration directory, the configuration directory is whichever you specify.

• For macOS, both the configuration directory and the data directory are located at ~/Library/Application Support/Clash Nyanpasu.

• For Linux:

  • The configuration directory is located at $XDG_CONFIG_HOME/clash-nyanpasu or $HOME/.config/clash-nyanpasu.
  • The data directory is located at $XDG_DATA_HOME/clash-nyanpasu or $HOME/.local/share/clash-nyanpasu.

If you need to get the logs yourself, you can navigate to the data directory and find the logs directory, which contains the log files of the current program.

3. How to edit the log level?

• In the Nyanpasu Setting option on the Settings page, you can find App Log Level to edit the log level, which takes effect immediately after saving.
• Find nyanpasu-config.yaml in the Config Dir, find the app_log_level field and edit the log level, and restart the app after saving.

The applicable log levels are trace, debug, info, warn, error, and silent(no logging).

4. How to enable TUN mode?

Note

TUN mode requires certain permissions.

• For Windows, run Clash Nyanpasu as an administrator to enable TUN mode.
• For macOS, click the Settings icon next to Clash Core on the Settings page, open core settings, click the small lock icon on the core side, enter the password for authorization, and restart the core.
• For Linux, similar to macOS, you can run with sudo to achieve authorization.

• In the Settings Page - System Settings option, enable TUN Mode.

Manual authorization on macOS

• If authorization is not successful, you can manually execute the following command. After authorization, a restart is still required.

# clash core
sudo chown root:admin /Applications/Clash\ Nyanpasu.app/Contents/MacOS/clash
sudo chmod +sx /Applications/Clash\ Nyanpasu.app/Contents/MacOS/clash

# mihomo core
sudo chown root:admin /Applications/Clash\ Nyanpasu.app/Contents/MacOS/mihomo
sudo chmod +sx /Applications/Clash\ Nyanpasu.app/Contents/MacOS/mihomo

# mihomo alpha core
sudo chown root:admin /Applications/Clash\ Nyanpasu.app/Contents/MacOS/mihomo-alpha
sudo chmod +sx /Applications/Clash\ Nyanpasu.app/Contents/MacOS/mihomo-alpha

# clash rust core
sudo chown root:admin /Applications/Clash\ Nyanpasu.app/Contents/MacOS/clash-rs
sudo chmod +sx /Applications/Clash\ Nyanpasu.app/Contents/MacOS/clash-rs

5. Missing subscription node types

Some subscription types recognize the User Agent (UA) of the request and deliver the corresponding configuration file based on the UA. The default UA for Nyanpasu is clash-nyanpasu/vx.y.z, where x.y.z represents the app version. If you are unable to retrieve certain types of nodes, it is likely because the subscription provider has not added the Nyanpasu UA for recognition.

Solutions

1. Contact the subscription provider and request support for the Nyanpasu UA;
2. Edit the UA to a type supported by the subscription provider, such as clash-meta, etc.

6. What are program directories and core directories? What are their roles?

In the current version, we refer to the program installation directory as the Application Directory or the Core Directory, which contains all current core and embedded resource files. You can open it by right-clicking the tray or finding the corresponding directory in the settings page.

When you need to manually install Nyanpasu service, you can find the service binaries in this way.