PPP: Difference between revisions
m (→pppoeconf: Rescued dead links) |
(rp-pppoe naming change) |
||
Line 17: | Line 17: | ||
==== PPPoE ==== | ==== PPPoE ==== | ||
This example peer file is based on Debian's [https://salsa.debian.org/debian/ppp/-/raw/master/debian/extra/peers-pppoe peers-pppoe] extra file. See that '' | This example peer file is based on Debian's [https://salsa.debian.org/debian/ppp/-/raw/master/debian/extra/peers-pppoe peers-pppoe] extra file. See that ''pppoe.so'' plugin as ''eth0'' as device defined. | ||
<pre> | <pre> | ||
user "myusername@realm" | user "myusername@realm" | ||
plugin | plugin pppoe.so eth0 | ||
noipdefault | noipdefault | ||
usepeerdns | usepeerdns | ||
Line 28: | Line 28: | ||
noauth | noauth | ||
</pre> | </pre> | ||
Note that if you have a version of ppp older than 2.4.9, the <code>pppoe.so</code> plugin is named <code>rp-pppoe</code>. | |||
=== Authentication === | === Authentication === |
Revision as of 21:53, 10 May 2023
Installation
PPP (Point-to-Point Protocol) allows multiple transports, eg. PPPoE is PPP over Ethernet.
PPPoE
apk add ppp-pppoe
Configure PPP
PPP peer file
Such file is usually located as /etc/ppp/peers/<isp>. See pppd(8) for all possible options.
PPPoE
This example peer file is based on Debian's peers-pppoe extra file. See that pppoe.so plugin as eth0 as device defined.
user "myusername@realm" plugin pppoe.so eth0 noipdefault usepeerdns defaultroute persist noauth
Note that if you have a version of ppp older than 2.4.9, the pppoe.so
plugin is named rp-pppoe
.
Authentication
CHAP authentication is most used one but there are other ones, see pppd(8).
/etc/ppp/chap-secrets
# Secrets for authentication using CHAP # client server secret IP addresses "myusername@realm" * "<your password>"
Kernel modules
PPPoE
pppoe must be present in /etc/modules when using PPPoE.
ifupdown-ng intergration
To use /etc/network/interfaces with a ppp defintion automatically, ifupdown-ng-ppp package must be installed.
apk add ifupdown-ng-ppp
Example for PPP configuration in /etc/network/interfaces, see interfaces-ppp(5) for more info.
auto eth0 iface eth0 up auto ppp0 iface ppp0 ppp-provider isp
Tips
pppoeconf
Debian created pppoeconf tool which helps configuring PPPoE. First some utils have to be installed.
apk add ppp-pppoe newt gettext sed
wget https://sources.debian.org/data/main/p/pppoeconf/1.21%2Bnmu2/pppoeconf
chmod +x ./pppoeconf && ./pppoeconf