Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
Next revisionBoth sides next revision
docs:guide-user:network:wan:wan_interface_protocols [2020/10/17 15:37] – fix reversed keepalive value description (ref: https://github.com/openwrt/luci/issues/4522) jowdocs:guide-user:network:wan:wan_interface_protocols [2024/01/07 19:06] – [Protocol "pppoe" (PPP over Ethernet)] fix questioned fields charles_harris
Line 27: Line 27:
 </code> </code>
  
-^ Name ^ Type ^ Required ^ Default ^ Description ^ Example ^ +^ Name              ^ Type                  ^ Required  ^ Default     ^ Description                                                                                                                                                                                                                                                                                         
-| ''username'' | string | no(?) | //(none)// | Username for PAP/CHAP authentication | | +| ''username''      | string                | no        | //(none)//  | Username for PAP/CHAP authentication |                                                                                                                                                                                                                                
-| ''password'' | string | no(?) | //(none)// | Password for PAP/CHAP authentication | | +| ''password''      | string                | no        | //(none)//  | Password for PAP/CHAP authentication |                                                                                                                                                                                                                                
-| ''ac'' | string | no | //(none)// | Specifies the Access Concentrator to connect to. If unset, ''pppd'' uses the first discovered one | | +| ''ac''            | string                | no        | //(none)//  | Specifies the Access Concentrator to connect to. If unset, ''pppd'' uses the first discovered one |                                                                                                                                                                    
-| ''service'' | string | no | //(none)// | Specifies the Service Name to connect to, If unset, ''pppd'' uses the first discovered one | | +| ''service''       | string                | no        | //(none)//  | Specifies the Service Name to connect to, If unset, ''pppd'' uses the first discovered one |                                                                                                                                                                          
-| ''connect'' | file path | no | //(none)// | Path to custom PPP connect script | | +| ''host_uniq''     | string                | no        | //(none)//  | Specifies the PPPoE Host-Uniq tag (hexstring) to connect with. If unset, it uses the ''pppd'' process ID                                                                                                                                                                   
-| ''disconnect'' | file path | no | //(none)// | Path to custom PPP disconnect script | | +| ''connect''       | file path             | no        | //(none)//  | Path to custom PPP connect script |                                                                                                                                                                                                                                    
-| ''keepalive'' | 2 numbers | no | //(none)// | The numbers must be separated by a space. First number is "we assume the connection is down after this number of pings failed" (**ppp**'s **lcp-echo-failure** option). Second number is for "seconds between each ping" (**ppp**'s **lcp-echo-interval** option). | option keepalive '5 5' +| ''disconnect''    | file path             | no        | //(none)//  | Path to custom PPP disconnect script |                                                                                                                                                                                                                                 
-| ''demand'' | number | no | //(none)// | Number of seconds to wait before closing the connection due to inactivity | | +| ''keepalive''     | 2 numbers             | no        ''5 1''  | The numbers must be separated by a space. First number is "we assume the connection is down after this number of pings failed" (**ppp**'s **lcp-echo-failure** option). Second number is for "seconds between each ping" (**ppp**'s **lcp-echo-interval** option). | 
-| ''defaultroute'' | boolean | no | ''1'' | Replace existing default route on PPP connect | | +| ''demand''        | number                | no        | //(none)//  | Number of seconds to wait before closing the connection due to inactivity |                                                                                                                                                                                            
-| ''peerdns'' | boolean | no | ''1'' | Use peer-assigned DNS server(s) | | +| ''defaultroute''  | boolean               | no        | ''1''       | Replace existing default route on PPP connect |                                                                                                                                                                                                                        
-| ''dns'' | list of ip addresses | no | //(none)// | Override peer-assigned DNS server(s) | | +| ''peerdns''       | boolean               | no        | ''1''       | Use peer-assigned DNS server(s) |                                                                                                                                                                                                                                      
-| ''ipv6'' | [0,1,auto] | no | ''auto'' | Enable IPv6 on the PPP link.  See Protocol "ppp" above | | +| ''dns''           | list of ip addresses  | no        | //(none)//  | Override peer-assigned DNS server(s) |                                                                                                                                                                                                                                 
-| ''pppd_options'' | string | no | //(none)// | Additional command line arguments to pass to the pppd daemone.g. **debug** | |+| ''ipv6''          | [0,1,auto]            | no        | ''auto''    | Enable IPv6 on the PPP link.  See Protocol "ppp" above |                                                                                                                                                                                                               
 +| ''pppd_options''  | string                | no        | //(none)//  | Additional command line arguments to pass to the pppd daemon e.g ''debug''                                                                                                                                                                                                        
  
 ===== Protocol "pppoa" (PPP over ATM AAL5) ===== ===== Protocol "pppoa" (PPP over ATM AAL5) =====
Line 80: Line 81:
 | ''dns'' | list of ip addresses | no | //(none)// | Override peer-assigned DNS server(s) | | ''dns'' | list of ip addresses | no | //(none)// | Override peer-assigned DNS server(s) |
 | ''ipv6'' | [0,1,auto] | no | ''auto'' | Enable IPv6 on the PPP link. See Protocol “ppp” above. | | ''ipv6'' | [0,1,auto] | no | ''auto'' | Enable IPv6 on the PPP link. See Protocol “ppp” above. |
 +| ''delay'' | number | no | 0 | Seconds to wait before trying to interact with the modem (some ZTE modems require up to 30 s.)|
  
 ===== Protocol "qmi" (USB modems using QMI protocol) ===== ===== Protocol "qmi" (USB modems using QMI protocol) =====
Line 123: Line 125:
 Below are a few examples for special, non-standard interface configurations. Below are a few examples for special, non-standard interface configurations.
  
-==== PPtP-over-PPPoE internet connection ==== +==== PPPoE internet connection ====
-<code bash> +
-config 'interface' 'wan' +
-        option 'proto'     'pppoe' +
-        option 'ifname'    'eth1' +
-        option 'username'  'user' +
-        option 'password'  'pass' +
-        option 'timeout'   '10' +
- +
-config 'interface' 'vpn' +
-        option 'proto'     'pptp' +
-        option 'ifname'    'vpn' +
-        option 'username'  'vpnuser' +
-        option 'password'  'vpnpass' +
-        option 'server'    'vpn.example.org' +
-</code> +
- +
-:!: Additionally the "wan" firewall zone must include both interfaces in ''/etc/config/firewall'': +
 <code bash> <code bash>
-config 'zone' +config interface 'wan' 
-        option 'name'      'wan' +        option proto     'pppoe
-        option 'network  'wan vpn'  # Important +        option device    'eth0
-        option 'input'     'REJECT+        option username  'user
-        option 'forward'   'REJECT+        option password  'pass
-        option 'output'    'ACCEPT+        option keepalive '4 5'
-        option 'masq'      '1'+
 </code> </code>
  
  • Last modified: 2024/01/18 14:00
  • by charles_harris