-
Notifications
You must be signed in to change notification settings - Fork 87
/
README-merlin.txt
269 lines (204 loc) · 9.46 KB
/
README-merlin.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
Asuswrt-Merlin
==============
About
-----
Asuswrt is the name of the firmware Asus has developed for
their various router models. Originally forked from Tomato,
it has since grown into a very different product, removing
some more technical features that were part of Tomato, but
also adding a lot of new original features.
Asuswrt-merlin is a customized version of Asus's firmware. The goal is
to provide bugfixes and minor enhancements to Asus's firmware, with also
a few occasional feature additions. This is done while retaining
the look and feel of the original firmware, and also ensuring that
the two codebases remain close enough so it will remain possible
to keep up with any new features brought by Asus in the original firmware.
This project's goal is NOT to develop yet another firmware filled with
many features that are rarely used by home users - that is already covered
by other excellent projects such as Tomato or DD-WRT.
This more conservative approach will also help ensuring the highest
level of stability possible. Priority is given to stability over
performance, and performance over features.
Supported Devices
-----------------
Fully supported devices:
386.x:
* RT-AC66U_B1 (use the RT-AC68U firmware)
* RT-AC68U, RT-AC68P, RT-AC68UF (including HW revision C1 and E1)
* RT-AC68U V3 (use the RT-AC68U firmware)
* RT-AC68U V4 (use the RT-AC68U firmware)
* RT-AC1900 & RT-AC1900P (use the RT-AC68U firmware)
* RT-AC88U
* RT-AC3100
* RT-AC5300
* RT-AC86U
* RT-AC2900 (use the RT-AC86U firmware)
* GT-AC2900
3004.388.x:
* RT-AX88U
* RT-AX58U & RT-AX3000 (V1 only)
* RT-AX86U & RT-AX86S
* GT-AX11000
* RT-AX68U
* GT-AXE11000
* GT-AX6000
* ZenWifi Pro XT12
* GT-AX11000 Pro
* GT-AXE16000
* RT-AX86U Pro
* RT-AX88U Pro
3006.102.x:
* RT-BE96U
* GT-BE98_PRO
No longer supported:
* RT-N16
* RT-N66U
* RT-AC66U
* RT-AC56U
* RT-AC87U
* RT-AC3200
* RT-AX56U
NOTE: all the "R" versions (for example RT-N66R) are the same as their
"U" counterparts, they are just different packages aimed at large
retailers. The firmware is 100% compatible with both U and R versions
of the routers. Same with the "W" variants that are simply white.
Features
--------
Here is a list of features that Asuswrt-merlin adds over the original
firmware.
(Note: HND platform = newer Broadcom models starting with RT-AC86U):
System:
- Various bugfixes
- Performance optimizations to some CPU-bound components like OpenVPN
- Some components were updated to their latest versions, for improved stability and security
- User scripts that run on specific events such as firewall restart
- Cron jobs for scheduled tasks
- Customizable config files for router services
- Third party software through Entware, with an easy setup script
- SNMP support (some models)
- Nano text editor (for more user-friendly script editing)
- NTP daemon, which can synchronize your client devices
- Third-party addons, with a management interface (AMTM)
Disk sharing:
- Optionally use shorter share names (folder name only)
- NFS exporting of USB drives
Networking:
- Act as a SMB Master Browser
- Act as a WINS server
- Allows tweaking TCP/UDP connection tracking timeouts
- CIFS client support (for mounting remote SMB share on the router)
- Advanced OpenVPN client and server.
- Netfilter ipset module, for efficient blacklist implementation
- DNS Director - enforcing the use of a specific DNS server, can be applied globally or per client
- Wireless site survey page
- Custom DDNS (through a user script)
- TOR support, individual client access control
- VPN Director - Policy-based routing for OpenVPN and WireGUard clients (based on source or destination IPs)
- Detailed wireless troubleshooting information (on some models)
- Redirect NTP client queries to the router's own NTP daemon
- Cake SQM QoS (on newer HND models)
Web interface:
- Performance improvements
- Optionally save traffic stats to disk (USB or JFFS partition)
- Enhanced traffic monitoring: adding graphical charts, and traffic monitoring per client IP
- Hostname field on the DHCP reservation list and Wireless ACL list
- System info summary page
- Wifi icon reports the state of both radios
- Advanced wireless client list display, including automated refresh
- Redesigned layout of the various System Log sections
- Editable entries (on some pages)
Note that a number of features which first appeared in Asuswrt-Merlin
have since been integrated/implemented in the official firmware, such
as OpenVPN support.
Installation
------------
Simply flash it like any regular update. You should not need to
reset to factory defaults (see note below for exceptions).
You can revert back to an original Asus firmware at any time just
by flashing a firmware downloaded from Asus's website.
Note that the archive for ROG models (like the GT-AX6000) may
contain two different firmware images. The one with _rog in
the filename uses the original ROG themed user interface, while
the other one uses the traditionnal blue/grey visuals used by
non-ROG models.
If the firmware upgrade fails, try rebooting your router to free
up sufficient memory, without any USB disk plugged in,
then try flashing it again.
NOTE: resetting to factory default after flashing is
strongly recommended for the following cases:
- Updating from a firmware version that is more than 3 releases older
- Switching from a Tomato/DD-WRT/OpenWRT firmware
If you run into any issue after an upgrade and you haven't done so,
try doing a factory default reset as well.
Always read the changelog, as mandatory resets will be mentionned
there when they are necessary.
In all of these cases, do NOT load a saved copy of your settings!
This would be the same thing as NOT resetting at all, as you will
simply re-enter any invalid setting you wanted to get rid of. Make
sure to create a new backup of your settings after reconfiguring.
Documentation
-------------
For documentation on how to use the features that are specific to
Asuswrt-Merlin, as well as additional guides, please consult the
wiki:
https://github.com/RMerl/asuswrt-merlin.ng/wiki
There are also support forums hosted at SNBForums.
Firmware support: https://www.snbforums.com/forums/asuswrt-merlin.42/
AddOns support: https://www.snbforums.com/forums/asuswrt-merlin-addons.60/
Source code
-----------
The source code can be found on Github:
https://github.com/RMerl/asuswrt-merlin.ng
Original pre-382.xx legacy code (now archived):
https://github.com/RMerl/asuswrt-merlin
Contact information
-------------------
SmallNetBuilder forums (preferred method: https://www.snbforums.com/forums/asuswrt-merlin.42/ as RMerlin)
Website: https://www.asuswrt-merlin.net/
Github: https://github.com/RMerl
Email: [email protected]
MAstodon: https://fosstodon.org/@RMerlin
IRC: RMerlin in channel #asuswrt on Libera
Download: https://www.asuswrt-merlin.net/download
Development news will be posted on Mastodon, and the support forums.
You can also keep a closer eye on development as it happens,
through the Github code repository.
For support questions, please use the SmallNetBuilder forums whenever
possible. There's a dedicated Asuswrt-Merlin sub-forum there, under
the Asus Wireless section. The community there is the primary source
of technical support.
I want to give my special thanks to Asus for showing an interest in
this project, and also providing me with support and development
devices when needed. I also want to thank everyone that has
donated through Paypal. Much appreciated!
Finally, my special thanks to r00t4rd3d for designing the
Asuswrt-Merlin logo.
Disclaimer
----------
This is the part where you usually put a lot of legalese stuff that nobody
reads. I'm not a lawyer, so I'll just make it simple, using my own words
rather than some pre-crafted text that will bore you to death and that
nobody but a highly paid lawyer would even understand anyway:
I take no responsibility for issues caused by this project. I do my best to
ensure that everything works fine. If something goes wrong, my apologies.
The Asuswrt-merlin firmware is released under a GPL licence. In short, you
are free to use, redistribute and modify it, as long as all the associated
licences are respected, and that any changes you make to the GPL code is
made publicly available.
Copyrights belong to the appropriate individuals/entities, under the appropriate
licences. GPL code is covered by GPL, proprietary code is Copyright their
respective owners, yadda yadda.
I try my best to honor the licences (as far as I can understand them, as a
normal human being). Anything GPL or otherwise open-sourced that I modify
will see my changes published to Github at some point. A release might get
delayed if I'm working using pre-release code. If it's GPL, it will eventually
be published - no need to send a volley of legal threats at me.
In any other cases not covered, Common Sense prevails, and I shall also make use
of Good Will.
Concerning privacy:
The only call back made by this firmware to me is when it checks for the
availability of a new version. The automated check can be disabled if desired.
More info on the Wiki:
https://github.com/RMerl/asuswrt-merlin.ng/wiki/Privacy-disclosure
---
Eric Sauvageau