📖
WannaFlix
WannaFlix (中文简体)
WannaFlix (中文简体)
  • Home
  • Which Protocol to Choose?
  • Which App to Choose?
  • 中文教程
    • 老教程
      • Windows
        • SSR
        • Netch (SSR + v2ray) - 推荐
    • 更新服务器列表
    • Windows
      • Clash for Windows (推荐)
      • v2rayN (v2ray)
    • Mac OS 苹果电脑
      • ClashX (SSR + v2ray) - 推荐
    • iOS 苹果手机/平板
      • Shadowrocket 小火煎 - 推荐
    • Android 安卓
      • ClashR (SSR + v2ray) - 推荐
    • Linux
      • Qv2ray
    • Merlin路由器
  • Windows
    • 👍Clash Verge (Recommended)
    • Clash For Windows (Legacy app)
    • Troubleshooting
  • Mac OS
    • 👍OneClick [M1 Macs ONLY] (Recommended)
    • ClashX Meta
    • Troubleshooting
  • iOS
    • 👍OneClick (Recommended)
    • Streisand
    • Switching iTunes Accounts
    • Troubleshooting
  • Android
    • 👍Clash for Android
    • Troubleshooting
  • Linux
    • V2ray
      • Qv2ray
  • Routers
    • Merlin
      • MerlinClash
      • V2ray
    • OpenWRT
      • OpenClash
      • Passwall
      • ShadowsocksR-Plus
    • SmartDNS
      • Generic Routers
      • Block Public DNS
  • Old Installation Guides
    • Eclipse (OpenVPN)
    • Windows
      • V2rayN (Legacy app) [v6.42+]
      • SmartDNS
      • WannaFlix Official App (Recommended)
      • V2rayN v3.18, v2.50
      • Clash For Windows (deprecated)
      • Clash for Windows
      • SSTap
      • SSR for Windows
      • Proxifier 4.05
      • Netch (Deprecated)
      • NekoRay [Deprecated]
      • Netch [Deprecated]
      • SSR [Deprecated]
    • Mac OS
      • Shadowrocket [M1 Macs ONLY]
      • ClashX v1.30.1 and Higher
      • ShadowsocksX-NG (Recommended)
      • Qv2ray (DEPRECATED)
      • ClashX v1.20 (deprecated)
      • ClashX
      • V2rayU 3.2.0 and Higher
      • Eclipse (OpenVPN)
      • SmartDNS
    • Android
      • Shadowsocks
        • V2rayNG (Recommended)
        • AnXray [Deprecated]
        • ClashR for Android [Deprecated]
      • Trojan
        • Clash for Android
        • v2rayNG (Recommended)
        • AnXray [Deprecated]
        • ClashR for Android (Deprecated)
      • Kitsunebi (Deprecated)
      • WannaFlix Official App (Recommended)
      • SSR
      • Eclipse (OpenVPN)
      • SmartDNS
    • iOS
      • Shadowrocket
      • Shadowrocket
      • Eclipse (OpenVPN)
      • SmartDNS
      • Quantumult (alternative app)
      • Quantumult (alternative app)
    • Linux
      • Shadowsocks-Qt5
    • Routers
      • Merlin-Koolshare Routers
      • Padavan Routers
    • Setup Guides
    • Switching to the New Protocol
    • SmartTV / Media Player
      • SmartDNS
        • SmartTVs
          • Samsung TVs
          • LG TVs
          • Sony TVs
        • Media Players
          • Apple TV
          • Amazon Fire TV
          • Roku
        • Gaming Consoles
          • XBOX 360
          • XBOX ONE
          • PS3 (Playstation 3)
          • PS4 (Playstation 4)
  • Troubleshooting
    • Troubleshooting
      • Download and install the vpn app
    • Your Account & Subscription
    • Installation Issues
    • Connection Issues
    • Netflix Issues
  • Optimizing your connection
  • FAQ
    • Netflix
    • China
    • Whatsapp
    • Support
    • Updating the Server List
    • Alternative Apps + Downloads
  • BLOG
    • May 26, 2025 China Updates
    • March 2023 China Updates - Recommend app updates and Protocol changes
    • WannaFlix's Situation in Iran
    • China Situation - April 2022
    • 2022 Updates
    • The Netflix Situation - August 2021
    • WannaFlix Features List
    • New Protocol!
    • What's new in January 2021?
    • What's new in December 2020?
    • About the Nov. 30 issues + New Servers
    • New Shadowsocks servers!
    • May 2020 Update
    • What affects VPN speeds in China? (26 March 2020)
  • VIP Servers
    • Routing
    • FAQ
  • Archives
    • 2022
    • 2021
      • What's New
      • Which Protocol to Choose? (old)
  • WannaFlix Sub-sites and Tools
  • Useful Websites/Tools
Powered by GitBook
On this page
  • Disclaimer
  • Buying Your Router
  • Routers
  • Flashing your router
  • Preparations
  • Download the KoolShare firmware
  • Flash your router with KoolShare
  • Enable JFFS
  • Install the APP (MerlinClash)
  • Install merlinclash.tar.gz on your router
  • Add Servers
  • Copy your API
  • Paste your API into MerlinClash
  • Connect
  • Select your config and start MerlinClash
  • Select your server
  • Additional resources

Was this helpful?

  1. Routers
  2. Merlin

MerlinClash

Disclaimer

We do NOT guarantee that our VPN will work with your specific router.

Each router is different. The same model may be flashed with a different version of the OS, and some routers may only support older OS versions which don't work with our App.

This guide is provided on a best-effort basis. There are too many variables to write an exhaustive guide that will work with all routers.

We provide you with links to external documentation and resources. Please refer to them if you get stuck. Most likely the issue you are facing has been addressed in those guides.

We do NOT provide extensive customer support for routers.

We only support routers listed in this guide below.

We only provide support for the configuration of the Merlin Clash app:

  • Where to put the API link and how to update it.

  • How to setup DNS to prevent DNS poisoning.

  • How to connect to a specific server.

We do NOT provide ticket support for:

  • Flashing your router

  • Installing the Merlin Clash app on the router

  • Exception: If links in this guide are no longer working, you can open a ticket with us to get working links.

However, we do provide this guide in English, as well as links to other resources you can read should you need more info.

We only support Merlin-Koolshare NOT Vanilla Merlin

You'll need to flash your router with one of the firmwares in the links in this guide below.

Additional resources:

Alright! With that out of the way, let's get started!

Buying Your Router

The Merlin Clash app for Merlin is part of the fancyss app package. It can only be run on a customized version of Merlin, Merlin-Koolshare.

Therefore, you'll need to get a router that can be flashed with Merlin-Koolshare (or that comes with it pre-installed).

Overview:

  1. Purchase a router that can run Merlin-koolshare

  2. Flash it with Merlin-Koolshare

  3. Download and install the FancySS app package

Routers

Please only purchase routers listed below

If you don't have a router listed in the links above, please do NOT continue with the guide. It will not work.

Flashing your router

Once you've bought your router, you'll need to flash it with Merlin-Koolshare.

Preparations

  1. Make sure you already have Merlin flashed on your device

  2. It is recommended to first update your Merlin firmware to the latest version from your router's manufacturer website or merlin's website before installing KoolShare.

Download the KoolShare firmware

Find which version of Fancyss your router supports from the router list above.

  1. Download the latest version of the firmware

Flash your router with KoolShare

  1. Login to your Merlin router

  2. Go to Administration > Firmware upgrade

  3. Click on "Choose file"

  4. Find your downloaded firmware and click "Upload"

Enable JFFS

Next, we need to enable JFFS to be able to upload MerlinClash to our router.

  1. Go to Administration > System

  2. Enable "Enable JFFS partition", "Format JFFS partition at next boot", and "Enable JFFS custom scripts and configs"

  3. Click "Apply" at the bottom of the page

  4. Reboot your router

Install the APP (MerlinClash)

First, you need to download the correct version of MerlinClash for your router.

You will need a telegram account to access the telegram group where the files are posted.

Then find the latest file for your router. You will need to know the CPU type of your router.

KoolCenter(KoolShare)Firmware:

ARM v8 HND版本 -- For AC86U/GT5300/AX68U/AX86U/AX88U/AX92U/AX1100/RAX80 etc.

ARM v7 AX32版本 -- For AX3000/AX6600/AX82/AX56/AX56Uv2/AX58U/AX89X/RAX50等

ARM v7 384/6版本 -- For routers that run Koolshare vservion 384/386 such as AC68U/AC88U/RT5300 etc.

ARM v7 380版本 -- For ARM v7 routers that run Koolshare version 380

Here is the Merlin Clash Wiki (you can use google translate to translate it to english):

IMPORTANT

Once downloaded, you have to rename the file to merlinclash.tar.gz

Install merlinclash.tar.gz on your router

  1. Login to your router

  2. Go to "软件中心" on the left menu

  3. Click on the "离线安装" tab at the top (see picture)

  4. Click on "Choose File" and select the [shadowsocks.tar.gz] file you downloaded in step 1

  5. Click on "上传并安装"

If you get an error message saying that the package is not allowed to be installed, you need to remove the restriction.

  1. Enable SSH in Administration > System

sed -i 's/\tdetect_package/\t# detect_package/g' /koolshare/scripts/ks_tat_install.sh

That is one line only.

Add Servers

Copy your API

  1. Go to the website dashboard

  2. Under Windows, select "Clash for windows"

  3. Copy the basic API for Clash

Paste your API into MerlinClash

  1. Go to your Koolshare app center (you can access it from the left-hand menu on Merlin)

  2. Click on MerlinClash to open the app

  3. Click on "配置文件“, the second tab from the right on the top menu

  4. Paste your API in the first box next to "小白一键订阅助手"

  5. Click "开始转换" to download the server list

If you have copied the full Clash API, you'll need to paste it in the second large box next to "Clash-Yaml配置下载", then click "Clash订阅“

Connect

Select your config and start MerlinClash

  1. Go back to the first tab "首页功能"

  2. Select your Config from the dropdown "配置文件选择"

  3. Start Clash by toggling the on/off switch

  4. Scroll to the bottom and click "保存&启动"

Select your server

  1. Scroll down and select either YACD-Clash or RAZORD-Clash to access the GUI (graphical user interface)

  2. Select a server

  3. Go to settings and select a Mode (for the Basic API, we recommend using the GLOBAL mode, for the full API, we recommend using the RULE mode). See screenshot for YACD settings.

Additional resources

PreviousMerlinNextV2ray

Last updated 1 year ago

Was this helpful?

- V2ray app repository, links to Merlin-Koolshare download locations [OUTDATED, DOES NOT WORK]

- Latest v2ray app repository for Merlin Koolshare 380

- Clash for Merlin, for those with Merlin Koolshare 384 and 386

- All available Merlin-Koolshare kernel downloads

Please find the supported routers list here:

If the link above doesn't work, go to and click on the highest version of "Koolcenter" (i.e. )

Find your router in the list and click on it:

Join the group:

SSH into your router (you can use on windows, or terminal on Mac) and run the following command:

See

MerlinClash official documentation (Chinese) {You can try google translating}:

FancySS Github
V2ray_bin Github
Merlin Clash Docs
Merlin-Koolshare kernels
https://fw.koolcenter.com/KoolCenter_Merlin_New_Gen_386
https://fw.koolcenter.com/
KoolCenter_梅林改版固件_386【新】
https://fw.koolcenter.com/KoolCenter_Merlin_New_Gen_386
https://t.me/merlinclashcat
putty
https://hq450.github.io/fancyss/
https://mcreadme.gitbook.io/mc/
简介MerlinClash Wiki
Logo