How to use HiddifyCli on OpenWrt

Complete Guide to Installing and Setting Up HiddifyCli on OpenWrt

To install HiddifyCli on OpenWrt, follow all the steps below in order. This guide includes downloading, extracting, installing, and full configuration.

---

1. Download HiddifyCli File

To download the version suitable for your router’s architecture, use the following command for direct download:

wget -O /tmp/HiddifyCli.tar.gz https://github.com/hiddify/hiddify-core/releases/download/latest/hiddify-cli-linux-{ARCH}.tar.gz  

Explanation:

• Replace {ARCH} with your router’s architecture (e.g., mips, arm, or x86_64).

---

2. Extract the File

After downloading, extract the file using the following command:

tar -xvzf /tmp/HiddifyCli.tar.gz -C /tmp  

Command Explanation:

• x- extracts the file.
• v- displays extraction details.
• z- opens gzip-compressed files.
• f- specifies the file name.
• /tmp/ is the extraction path (you can replace it with your preferred directory).

---

3. Move the Executable to the Appropriate Directory

Move the HiddifyCli executable file to /usr/bin/ using:

mv /tmp/HiddifyCli /usr/bin/  

---

4. Set Execution Permissions

To enable execution for the file, enter the following command:

chmod +x /usr/bin/HiddifyCli  

---

5. Create an Init Script

To create an automatic service:
1. Create a file named HiddifyCli in /etc/init.d/:

touch /etc/init.d/HiddifyCli  

1. Fill the file with the following content:

#!/bin/sh /etc/rc.common  
START=91  
USE_PROCD=1  

start_service() {  
    procd_open_instance  
    procd_set_param command /usr/bin/HiddifyCli run -c /root/config.conf  
    procd_set_param stdout 1  
    procd_set_param stderr 1  
    procd_set_param respawn  
    procd_close_instance  
}  

1. Set the file permissions:

chmod 755 /etc/init.d/HiddifyCli  

---

6. Enable and Start the Service

Run the following commands to enable and start the service:

service HiddifyCli enable  
service HiddifyCli start  

---

7. Configure the Settings

1. Extract the Configuration from Hiddify Desktop App:
2. Set up your desired configurations in the app.
3. Export the config and save it as a text file.

4. Rename the file extension to .conf (e.g., config.conf).

5. Move the Config File to /root/ on the Router:

mv config.conf /root/  

---

8. Reboot the Router

Restart the router to apply the changes:

reboot  

After rebooting, the HiddifyCli service will be active, and the Socks5 Proxy will be available at:

127.0.0.1:12334  

---

Additional Notes:

• To check the router’s architecture, run the following command:

uname -m  

• If any issues arise during the process, check the service logs using:

logread | grep HiddifyCli  

In another article, we will explain how to enable free internet access for clients behind the router.

---

Last update: December 28, 2024

Comments