PPP: Difference between revisions

From Alpine Linux
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 ''rp-pppoe.so'' plugin as ''eth0'' as device defined.
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 rp-pppoe.so eth0
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