0.6.1
- Fewer needless route changes when the router itself refuses outgoing traffic.
- To update an existing router, follow "Update the ForestVPN container on MikroTik".
- Tested for an hour on an arm64 MikroTik router before release, with no reconnects.
ForestVPN كحاوية على مُوجِّه MikroTik يشغّل RouterOS 7. يسجّل نفسه جهازًا مستقلًا ويطبع رمز اقتران.
حاوية RouterOS، تم التحقق منها على أجهزة حقيقية — جهاز MikroTik cAP ax جلب الصورة، وسجّل، وطبع رمز إقران، واتصل. يحمل مفتاح جهازه الخاص ويطلب من طبقة التحكم نقطة خروج بالطريقة نفسها التي يفعلها الهاتف.
ثلاثة أسطر في طرفية RouterOS — شبكة فرعية /30 لا توجد إلا بين الحاوية والراوتر، لا شيء تبحث عنه في شبكتك المحلية.
صورة مثبَّتة الإصدار، لا :latest — راوتر لست واقفًا أمامه يجب ألا يبدّل ما يشغّله بصمت أبدًا.
يُطبع في /log قبل أن تملك الحاوية أي وصول للشبكة على الإطلاق. افتح تطبيق ForestVPN، وقد سجّلت الدخول فيه برقم حسابك، وأدخل الرمز.
يقدّم الراوتر صفحة حالته الخاصة على العنوان الذي منحته له للتو — افتحها من هاتف على الشبكة نفسها واضغط موقعًا. هذا هو الشيء الوحيد الذي لا يستطيع جهاز بلا شاشة القيام به بنفسه.
# Optional, paste first: :global fvLAN "all" sends the whole LAN through the tunnel, with a kill switch.
{
:global fvMODE "private"
# --- optional, pasted BEFORE this file (leave them out for the defaults) -----------------------
# :global fvLAN "all" the whole LAN through the tunnel, with a kill switch. Also
# "devices", "services" or "rules"; see the LAN routing set below.
# :global fvREMOVEOLD "yes" remove the previous ForestVPN setup (qproxy, WireGuard fvpn0) first
# :global fvBR "bridge" your LAN bridge, if it is not MikroTik's default name
# :global fvWAN "WAN" the interface list that holds your internet interface
:global fvLAN
:global fvREMOVEOLD
:global fvBR
:global fvWAN
:global fvCT
:if ([:typeof $fvLAN] = "nothing") do={ :set fvLAN "off" }
:if ([:typeof $fvREMOVEOLD] = "nothing") do={ :set fvREMOVEOLD "no" }
:if ([:typeof $fvBR] = "nothing") do={ :set fvBR "bridge" }
:if ([:typeof $fvWAN] = "nothing") do={ :set fvWAN "WAN" }
:if (!($fvLAN = "off" || $fvLAN = "all" || $fvLAN = "devices" || $fvLAN = "services" || $fvLAN = "rules")) do={ :error ("ForestVPN: fvLAN is \"" . $fvLAN . "\"; use all, devices, services, rules or off.") }
:if ($fvLAN != "off") do={
:if ($fvMODE != "private") do={ :error "ForestVPN: fvLAN works only in the default private mode, on the router that routes your LAN." }
:if ([:len [/interface/find where name=$fvBR]] != 1) do={ :error ("ForestVPN: there is no interface called " . $fvBR . ". Paste :global fvBR \"<your LAN bridge>\" first.") }
:if ([:len [/interface/list/member/find where list=$fvWAN]] = 0) do={ :error ("ForestVPN: the interface list " . $fvWAN . " is missing or empty. Paste :global fvWAN \"<your internet list>\" first.") }
}
# >>> forestvpn previous generation >>>
# The ForestVPN router setup before this app: a qproxy container on a "containers" bridge
# (172.17.0.0/24), a WireGuard interface fvpn0 in the WAN list, the address list under_fvpn, a
# routing table fvpn with the "ForestVPN Kill Switch" rule, and their mangles. Left in place, its
# kill switch and mangles keep steering the LAN into a tunnel that no longer exists.
:local old [:toarray ""]
:if ([:len [/container/find where name~"qproxy"]] > 0) do={ :set old ($old , "the qproxy container") }
:if ([:len [/interface/wireguard/find where name="fvpn0"]] > 0) do={ :set old ($old , "WireGuard interface fvpn0") }
:if ([:len [/ip/firewall/address-list/find where list="under_fvpn"]] > 0) do={ :set old ($old , "address list under_fvpn") }
:if ([:len [/routing/table/find where name="fvpn"]] > 0) do={ :set old ($old , "routing table fvpn") }
:if ([:len [/routing/rule/find where table="fvpn" or comment~"ForestVPN Kill Switch"]] > 0) do={ :set old ($old , "the ForestVPN Kill Switch rule") }
:if ([:len [/ip/firewall/mangle/find where src-address-list="under_fvpn" or connection-mark="under_fvpn" or out-interface="fvpn0" or in-interface="fvpn0"]] > 0) do={ :set old ($old , "its mangle rules") }
:if ([:len [/interface/list/member/find where interface="fvpn0"]] > 0) do={ :set old ($old , "fvpn0 in an interface list") }
:if ([:len $old] > 0) do={
:global fvREMOVEOLD
:if ($fvREMOVEOLD != "yes") do={ :error ("ForestVPN: this router still has the previous ForestVPN setup (" . [:tostr $old] . "). Nothing was changed. To remove it, paste :global fvREMOVEOLD \"yes\" and then this again: fvpn.net/help/mikrotik-remove-old/") }
:put ("ForestVPN: removing the previous ForestVPN setup: " . [:tostr $old] . ". Your configuration before this is saved as forestvpn-before-removal.rsc.")
/export file=forestvpn-before-removal
:foreach c in=[/container/find where name~"qproxy"] do={
:do { /container/stop $c } on-error={}
:local n 0
:while ([/container/get $c running] && $n < 30) do={ :delay 1s; :set n ($n + 1) }
:delay 2s
/container/remove $c
}
/ip/firewall/mangle/remove [find where src-address-list="under_fvpn" or connection-mark="under_fvpn" or out-interface="fvpn0" or in-interface="fvpn0" or (chain="prerouting" and action="accept" and dst-address="192.168.88.1")]
/ipv6/firewall/mangle/remove [find where src-address-list="under_fvpn" or connection-mark="under_fvpn"]
/routing/rule/remove [find where table="fvpn" or comment~"ForestVPN Kill Switch"]
/ip/route/remove [find where routing-table="fvpn"]
/ipv6/route/remove [find where routing-table="fvpn"]
/interface/wireguard/peers/remove [find where interface="fvpn0"]
/interface/list/member/remove [find where interface="fvpn0"]
/ip/address/remove [find where interface="fvpn0"]
/ipv6/address/remove [find where interface="fvpn0" and !dynamic]
/interface/wireguard/remove [find where name="fvpn0"]
/routing/table/remove [find where name="fvpn"]
/ip/firewall/address-list/remove [find where list="under_fvpn"]
/interface/bridge/port/remove [find where interface~"veth-qproxy"]
/interface/veth/remove [find where name~"veth-qproxy"]
# The "containers" bridge, its address and its 172.17.0.0/24 masquerade only if nothing else is
# still on it: MikroTik's own container guide uses the same names, so other containers may share them.
:if ([:len [/interface/bridge/find where name="containers"]] = 1 and [:len [/interface/bridge/port/find where bridge="containers"]] = 0) do={
/ip/firewall/nat/remove [find where src-address="172.17.0.0/24"]
/ip/address/remove [find where interface="containers"]
/interface/list/member/remove [find where interface="containers"]
/interface/bridge/remove [find where name="containers"]
}
:if ([:len [/container/find where name~"qproxy"]] + [:len [/interface/wireguard/find where name="fvpn0"]] + [:len [/routing/table/find where name="fvpn"]] + [:len [/ip/firewall/address-list/find where list="under_fvpn"]] > 0) do={ :error "ForestVPN: the previous setup could not be removed completely. See /export and fvpn.net/help/mikrotik-remove-old/." }
}
# <<< forestvpn previous generation <<<
:global fvCT "172.31.254.2"
/interface/veth/add name=veth-fvpn address=172.31.254.2/30 gateway=172.31.254.1
/ip/address/add address=172.31.254.1/30 interface=veth-fvpn
/interface/list/member/add list=LAN interface=veth-fvpn
# A `flash` folder (hAP ac² and other 16 MB boards) means only flash/ survives a reboot: the state
# goes there, the log stays in RAM, and the image is pulled again at every boot.
:global fvRAMROOT ([:len [/file/find where name="flash"]] > 0)
:global fvSTATE "/forestvpn"
:global fvCMD "--agent --nat-lan --iface fvpn0 --config /etc/forestvpn/fvpn0.conf --policy-route --fwmark 51820 --table 100 --http-port 80 --report /etc/forestvpn/result.txt"
:if ($fvRAMROOT) do={
:global fvSTATE
:global fvCMD
:set fvSTATE "flash/forestvpn"
:set fvCMD ($fvCMD . " --log-dir /var/log")
}
/container/mounts/add list=fvpn-state src=$fvSTATE dst=/etc/forestvpn mode=rw
/container/add remote-image=suquant/fvpn:0.6.1 interface=veth-fvpn root-dir=/fvpn \
mountlists=fvpn-state entrypoint=/mikrotik.sh cmd=$fvCMD \
privileged=yes logging=yes start-on-boot=yes dns=172.31.254.1 name=fvpn
:if ($fvRAMROOT) do={
/container/set [find name="fvpn"] start-on-boot=no
/system/script/add name=forestvpn-repull comment="forestvpn" source={
:local c [/container/find where name="fvpn"]
:if ([:len $c] = 1) do={
:local n 0
:while ((![/container/get $c running]) && ($n < 60)) do={
:set n ($n + 1)
:log info ("ForestVPN: pulling the image into the RAM root, attempt " . $n)
:do { /container/repull $c } on-error={}
:local w 0
:local s ""
:while (($w < 60) && ($s = "")) do={
:set w ($w + 1)
:delay 5s
:local st [:pick [/container/print as-value where name="fvpn"] 0]
:if (($st->"stopped") = true) do={ :set s "stopped" }
:if (($st->"download/extract failed") = true) do={ :set s "failed" }
}
:if ($s = "stopped") do={
:do { /container/start $c } on-error={}
:delay 30s
} else={
:log warning "ForestVPN: image pull failed, retrying in 60s"
:delay 60s
}
}
:if (![/container/get $c running]) do={
:log error "ForestVPN: the container is still not running after 60 pulls; see /container/print"
}
}
}
/system/scheduler/add name=forestvpn-repull start-time=startup comment="forestvpn" \
on-event="/system/script/run forestvpn-repull"
}
/container/start [find name="fvpn"]
# >>> forestvpn LAN routing set >>>
# The one copy is crates/fv/src/portal/lan.rsc. install.rsc and the download page carry it verbatim
# (tests compare them), and the status page's routing tab prints it after four :global lines.
# fvLAN all | devices | services | rules what is sent through the tunnel ("rules": only
# the table, kill switch and plumbing, for your own
# mark-routing rules with new-routing-mark=via-fvpn)
# fvBR the LAN bridge (MikroTik's default is "bridge")
# fvWAN the interface list that holds the internet interface (default "WAN")
# fvCT the container's address on veth-fvpn (the install's private mode: 172.31.254.2)
# Every object this adds has a comment starting "forestvpn". Pasting it again first removes them
# all, then adds the current set, so a second paste changes nothing.
:global fvLAN
:global fvBR
:global fvWAN
:global fvCT
:if ($fvLAN = "all" || $fvLAN = "devices" || $fvLAN = "services" || $fvLAN = "rules") do={
:global fvLAN
:global fvBR
:global fvWAN
:global fvCT
:if ([:len [/interface/veth/find where name="veth-fvpn"]] != 1) do={ :error "ForestVPN: there is no veth-fvpn on this router. Run the install first, on this router." }
:if ([:len [/interface/bridge/port/find where interface="veth-fvpn"]] > 0) do={ :error "ForestVPN: veth-fvpn is a bridge port (the install's lan mode). This set is for the default private mode, on the router that routes your LAN." }
:if ([:len [/interface/find where name=$fvBR]] != 1) do={ :error ("ForestVPN: there is no interface called " . $fvBR . ". Paste :global fvBR \"<your LAN bridge>\" (see /interface/bridge/print), then this again.") }
:if ([:len [/interface/list/member/find where list=$fvWAN]] = 0) do={ :error ("ForestVPN: the interface list " . $fvWAN . " is missing or empty, so the kill switch would drop nothing. Paste :global fvWAN \"<the list that holds your internet interface>\" , then this again.") }
# Converge: remove whatever an earlier copy added (this set, the status page's older script, or the
# 2026-10 hand-built set on the first customer routers, whose comments also start "forestvpn").
# Nothing the installer adds lives in these menus.
/ip/firewall/mangle/remove [find where comment~"^forestvpn"]
/ip/firewall/filter/remove [find where comment~"^forestvpn"]
/ip/firewall/nat/remove [find where comment~"^forestvpn"]
/ipv6/firewall/filter/remove [find where comment~"^forestvpn"]
/routing/rule/remove [find where comment~"^forestvpn"]
/ip/route/remove [find where routing-table="via-fvpn" and !dynamic]
/ip/firewall/address-list/remove [find where list="forestvpn-direct"]
# The table. Marked traffic goes to the container; when the container is gone the blackhole takes
# over, and the rule stops a marked packet from ever falling back to the main table.
:if ([:len [/routing/table/find where name="via-fvpn"]] = 0) do={ /routing/table/add name=via-fvpn fib comment="forestvpn" }
/ip/route/add dst-address=0.0.0.0/0 gateway=$fvCT routing-table=via-fvpn comment="forestvpn: LAN default via the ForestVPN container"
/ip/route/add dst-address=0.0.0.0/0 blackhole routing-table=via-fvpn distance=250 comment="forestvpn kill switch: no tunnel, no internet"
/routing/rule/add routing-mark=via-fvpn action=lookup-only-in-table table=via-fvpn comment="forestvpn kill switch: never fall back to main"
# Private ranges stay off the tunnel, so LAN-to-LAN routing, the modem's own page and the
# container's /30 keep working.
:foreach p in={"10.0.0.0/8";"172.16.0.0/12";"192.168.0.0/16"} do={ /ip/firewall/address-list/add list=forestvpn-direct address=$p comment="forestvpn: private ranges stay off the tunnel" }
# What is marked. Every mark is anchored to the LAN bridge, so the container's own traffic, which
# arrives on veth-fvpn, is never routed back into the container.
:if ($fvLAN = "all") do={
/ip/firewall/mangle/add chain=prerouting in-interface=$fvBR dst-address-type=!local dst-address-list=!forestvpn-direct action=mark-routing new-routing-mark=via-fvpn passthrough=yes comment="forestvpn: whole LAN through the tunnel"
/ip/firewall/filter/add chain=forward in-interface=$fvBR out-interface-list=$fvWAN dst-address-list=!forestvpn-direct action=drop comment="forestvpn kill switch: LAN never reaches the WAN directly"
}
:if ($fvLAN = "devices") do={
/ip/firewall/mangle/add chain=prerouting in-interface=$fvBR src-address-list=fvpn-clients dst-address-type=!local dst-address-list=!forestvpn-direct action=mark-routing new-routing-mark=via-fvpn passthrough=yes comment="forestvpn: named devices through the tunnel"
/ip/firewall/filter/add chain=forward src-address-list=fvpn-clients out-interface-list=$fvWAN dst-address-list=!forestvpn-direct action=drop comment="forestvpn kill switch: named devices never reach the WAN directly"
:if ([:len [/ip/firewall/address-list/find where list="fvpn-clients"]] = 0) do={ :put "ForestVPN: the fvpn-clients list is empty, so nothing is sent yet. Add a device: /ip/firewall/address-list/add list=fvpn-clients address=<its IP>" }
}
:if ($fvLAN = "services") do={
:if ([:len [/ip/firewall/address-list/find where list="fvpn-dst"]] = 0) do={
# A starting point that drifts. Refresh: core.telegram.org/resources/cidr.txt and Meta's published ranges.
/ip/firewall/address-list/add list=fvpn-dst address=91.108.4.0/22 comment="telegram"
/ip/firewall/address-list/add list=fvpn-dst address=149.154.160.0/20 comment="telegram"
/ip/firewall/address-list/add list=fvpn-dst address=157.240.0.0/16 comment="meta/whatsapp"
/ip/firewall/address-list/add list=fvpn-dst address=31.13.64.0/18 comment="meta/whatsapp"
}
/ip/firewall/mangle/add chain=prerouting in-interface=$fvBR dst-address-list=fvpn-dst action=mark-routing new-routing-mark=via-fvpn passthrough=yes comment="forestvpn: named services through the tunnel"
/ip/firewall/filter/add chain=forward in-interface=$fvBR dst-address-list=fvpn-dst out-interface-list=$fvWAN action=drop comment="forestvpn kill switch: named services never leave over the WAN"
}
# Traffic the container hands back. A container whose tunnel is down forwards to its own default
# gateway, which is this router; that traffic must never continue out the WAN.
/ip/firewall/filter/add chain=forward in-interface=veth-fvpn src-address=("!" . $fvCT) connection-state=new action=drop comment="forestvpn kill switch: LAN traffic the container hands back never goes out the WAN"
# Required, not optional, on images before 0.3.20: the container routes any reply whose destination
# is not on its own /30 back into the tunnel, so the LAN must reach it as this router. 0.3.20 adds a
# rule inside the container for the same job; this one stays for older images.
/ip/firewall/nat/add chain=srcnat out-interface=veth-fvpn action=masquerade comment="forestvpn: LAN reaches the container as the router, so the container can answer it"
# MSS: the tunnel MTU is 1416 (fv --mtu default); 1416 - 80 leaves room for TCP options and an IPv6
# inner header. Both directions: the LAN's SYN and the server's SYN-ACK.
/ip/firewall/mangle/add chain=forward in-interface=$fvBR out-interface=veth-fvpn protocol=tcp tcp-flags=syn tcp-mss=1337-65535 action=change-mss new-mss=1336 passthrough=yes comment="forestvpn: MSS for the tunnel MTU 1416, LAN to tunnel"
/ip/firewall/mangle/add chain=forward in-interface=veth-fvpn out-interface=$fvBR protocol=tcp tcp-flags=syn tcp-mss=1337-65535 action=change-mss new-mss=1336 passthrough=yes comment="forestvpn: MSS for the tunnel MTU 1416, tunnel to LAN"
# FastTrack routes by the main table and skips the firewall, so a fasttracked tunnelled flow would
# leave over the WAN, past the kill switch. Keep LAN<->container flows out of it. The container's
# own tunnel traffic (veth-fvpn to WAN) still fasttracks.
:local ft [/ip/firewall/filter/find where chain=forward and action=fasttrack-connection and !disabled]
:if ([:len $ft] > 0) do={
/ip/firewall/filter/add chain=forward in-interface=$fvBR out-interface=veth-fvpn connection-state=established,related action=accept place-before=($ft->0) comment="forestvpn: tunnelled flows skip fasttrack"
/ip/firewall/filter/add chain=forward in-interface=veth-fvpn out-interface=$fvBR connection-state=established,related action=accept place-before=($ft->0) comment="forestvpn: tunnelled replies skip fasttrack"
}
:if ($fvLAN = "all") do={
# DNS: queries addressed to this router are local, so they are not marked and would resolve over
# the WAN. Hand the LAN public resolvers instead; their queries are then marked like anything else.
:foreach a in=[/ip/address/find where interface=$fvBR and !disabled] do={
:local s [:tostr [/ip/address/get $a address]]
:local ip [:toip [:pick $s 0 [:find $s "/"]]]
:foreach n in=[/ip/dhcp-server/network/find] do={
:if ($ip in [/ip/dhcp-server/network/get $n address]) do={
:local was [:tostr [/ip/dhcp-server/network/get $n dns-server]]
:if ($was != "1.1.1.1,8.8.8.8" and $was != "1.1.1.1;8.8.8.8") do={
/ip/dhcp-server/network/set $n dns-server=1.1.1.1,8.8.8.8
:put ("ForestVPN: DHCP DNS for " . [/ip/dhcp-server/network/get $n address] . " was \"" . $was . "\", now 1.1.1.1,8.8.8.8 (through the tunnel). Devices pick it up when they renew their lease.")
}
}
}
}
# IPv6: the container has no IPv6 address, so the tunnel is IPv4 only. Refuse the LAN's IPv6
# forwarding, with an error rather than silence, so devices fall back to IPv4 at once.
:local v6 [/ipv6/firewall/filter/find]
:if ([:len $v6] > 0) do={
/ipv6/firewall/filter/add chain=forward in-interface=$fvBR out-interface-list=$fvWAN action=reject reject-with=icmp-no-route place-before=($v6->0) comment="forestvpn kill switch: no LAN IPv6 around the IPv4-only tunnel"
} else={
/ipv6/firewall/filter/add chain=forward in-interface=$fvBR out-interface-list=$fvWAN action=reject reject-with=icmp-no-route comment="forestvpn kill switch: no LAN IPv6 around the IPv4-only tunnel"
}
}
# Connections opened before this paste keep their old path (a fasttracked one never comes back to
# these rules). Clear the LAN's, so every flow is decided again.
# ponytail: matches the bridge address's first three octets; a LAN wider than /24 keeps older flows until they end.
:foreach a in=[/ip/address/find where interface=$fvBR and !disabled] do={
:local s [:tostr [/ip/address/get $a address]]
:local d1 [:find $s "."]
:local d2 [:find $s "." ($d1 + 1)]
:local d3 [:find $s "." ($d2 + 1)]
:local re ("^" . [:pick $s 0 $d1] . "\\." . [:pick $s ($d1 + 1) $d2] . "\\." . [:pick $s ($d2 + 1) $d3] . "\\.")
/ip/firewall/connection/remove [find where src-address~$re]
}
:put ("ForestVPN: LAN routing set applied: " . $fvLAN . ", LAN " . $fvBR . ", internet list " . $fvWAN . ".")
}
# <<< forestvpn LAN routing set <<<
/system/script/environment/remove [find where name="fvLAN" or name="fvREMOVEOLD" or name="fvBR" or name="fvWAN" or name="fvCT"]
}كل سطر أساسي، و`cmd=` أهمّها.
بلا `--agent` يشغّل نقطة الدخول المُشغِّل الخام بدلًا من ذاك المُدار بالحساب، ويبحث عن ملف `.conf` لم يكتبه أحد، وتخرج الحاوية برسالة `fvpn0 never appeared`. النقطة الأخرى هي التركيب (mount): الصورة هي `scratch`، فلا شيء ينجو من إعادة التشغيل سوى ما هو مُركَّب، وفقدان تركيب مفتاح الجهاز يعني أن الراوتر يعود كجهاز جديد تمامًا سقط بصمت عن حسابك.
يُطبع في /log، ويقدّم المُوجِّه صفحة حالة على http://172.31.254.2/.
افتح ForestVPN على هاتف سجّلت الدخول فيه وأدخل الرمز. يتم الربط من التطبيق لا من المُوجِّه.
في صفحة الحالة اضغط على موقع.
غير متوفر بعد على MikroTik: اختيار المواقع أو الخدمات حسب الوجهة من داخل ForestVPN. يتخذ RouterOS قرار التوجيه.
الصورة هي suquant/fvpn:0.6.1. الوسم مثبَّت ومنشور على Docker Hub؛ وتستخدم كتلة التثبيت هذا الوسم تحديدًا.
أوقف الحاوية وأزلها بالأمرين /container/stop و/container/remove، ثم احذف veth وعنوانها، وكذلك قواعد سكربت التوجيه (تبدأ تعليقاتها بـ forestvpn). يبقى الجهاز في حسابك إلى أن تزيله في التطبيق.
أي مُوجِّه يشغّل RouterOS 7.21 أو أحدث مع حزمة container. تُبنى الصورة لـarm وarm64 وx86، وقد جرى التحقق منها على عتاد arm64 حقيقي.
لا، للتثبيت البسيط بالحاوية المعروض هنا. اللوحات ذات مجلد flash تحتفظ بذلك المجلد فقط بعد إعادة التشغيل، والكتلة تتولى ذلك.
لا. يثبّت التثبيت وسم صورة حتى لا يغيّر مُوجِّه لست بقربه ما يشغّله دون أن تدري.