diff --git a/docs/manage-users-zh.md b/docs/manage-users-zh.md index 67f7c48..cdf8bf7 100644 --- a/docs/manage-users-zh.md +++ b/docs/manage-users-zh.md @@ -42,57 +42,86 @@ service xl2tpd restart ## 使用辅助脚本管理 VPN 用户 -你可以使用这些脚本来更方便地管理 VPN 用户:[add_vpn_user.sh](../extras/add_vpn_user.sh), [del_vpn_user.sh](../extras/del_vpn_user.sh) 和 [update_vpn_users.sh](../extras/update_vpn_users.sh)。它们将同时更新 IPsec/L2TP 和 IPsec/XAuth ("Cisco IPsec") 模式的用户。将下面的命令的参数换成你自己的值。对于 IKEv2,参见 [管理客户端证书](ikev2-howto-zh.md#管理客户端证书)。 +你可以使用辅助脚本 [添加](../extras/add_vpn_user.sh), [删除](../extras/del_vpn_user.sh) 或者 [更新所有的](../extras/update_vpn_users.sh) VPN 用户。它们将同时更新 IPsec/L2TP 和 IPsec/XAuth ("Cisco IPsec") 模式的用户。对于 IKEv2 模式,请另外参见 [管理客户端证书](ikev2-howto-zh.md#管理客户端证书)。 -**注:** VPN 用户信息保存在文件 `/etc/ppp/chap-secrets` 和 `/etc/ipsec.d/passwd`。脚本在修改这些文件之前会先做备份,使用 `.old-日期-时间` 为后缀。 +**注:** 将下面的命令的参数换成你自己的值。VPN 用户信息保存在文件 `/etc/ppp/chap-secrets` 和 `/etc/ipsec.d/passwd`。脚本在修改这些文件之前会先做备份,使用 `.old-日期-时间` 为后缀。 ### 添加或更改一个 VPN 用户 添加一个新 VPN 用户,或者为一个已有的 VPN 用户更改密码。 +运行脚本并按提示操作: + ```bash -# 下载脚本 -wget -nv -O add_vpn_user.sh https://bit.ly/addvpnuser -# 运行脚本并按提示操作 -sudo bash add_vpn_user.sh +sudo addvpnuser.sh ``` +
+ +错误:"sudo: addvpnuser.sh: command not found". + + +如果你使用了较早版本的 VPN 安装脚本,这是正常的。首先下载辅助脚本: + +```bash +wget -nv -O /opt/src/addvpnuser.sh https://bit.ly/addvpnuser +chmod +x /opt/src/addvpnuser.sh && ln -s /opt/src/addvpnuser.sh /usr/bin +``` + +然后按照说明运行脚本。 +
+ 另外,你也可以在添加参数的情况下运行脚本: ```bash # 所有变量值必须用 '单引号' 括起来 # *不要* 在值中使用这些字符: \ " ' -sudo bash add_vpn_user.sh '要添加的用户名' '密码' +sudo addvpnuser.sh '要添加的用户名' '密码' # 或者 -sudo bash add_vpn_user.sh '要更新的用户名' '新密码' +sudo addvpnuser.sh '要更新的用户名' '新密码' ``` ### 删除一个 VPN 用户 删除指定的 VPN 用户。 +运行脚本并按提示操作: + ```bash -# 下载脚本 -wget -nv -O del_vpn_user.sh https://bit.ly/delvpnuser -# 运行脚本并按提示操作 -sudo bash del_vpn_user.sh +sudo delvpnuser.sh ``` +
+ +错误:"sudo: delvpnuser.sh: command not found". + + +如果你使用了较早版本的 VPN 安装脚本,这是正常的。首先下载辅助脚本: + +```bash +wget -nv -O /opt/src/delvpnuser.sh https://bit.ly/delvpnuser +chmod +x /opt/src/delvpnuser.sh && ln -s /opt/src/delvpnuser.sh /usr/bin +``` + +然后按照说明运行脚本。 +
+ 另外,你也可以在添加参数的情况下运行脚本: ```bash # 所有变量值必须用 '单引号' 括起来 # *不要* 在值中使用这些字符: \ " ' -sudo bash del_vpn_user.sh '要删除的用户名' +sudo delvpnuser.sh '要删除的用户名' ``` ### 更新所有的 VPN 用户 移除所有的 VPN 用户并替换为你指定的列表中的用户。 +首先下载脚本: + ```bash -# 下载脚本 -wget -nv -O update_vpn_users.sh https://bit.ly/updatevpnusers +wget -nv -O updatevpnusers.sh https://bit.ly/updatevpnusers ``` 要使用这个脚本,从以下选项中选择一个: @@ -102,9 +131,9 @@ wget -nv -O update_vpn_users.sh https://bit.ly/updatevpnusers **选项 1:** 编辑脚本并输入 VPN 用户信息: ```bash -nano -w update_vpn_users.sh +nano -w updatevpnusers.sh [替换为你自己的值: YOUR_USERNAMES 和 YOUR_PASSWORDS] -sudo bash update_vpn_users.sh +sudo bash updatevpnusers.sh ``` **选项 2:** 将 VPN 用户信息定义为环境变量: @@ -116,7 +145,7 @@ sudo bash update_vpn_users.sh sudo \ VPN_USERS='用户名1 用户名2 ...' \ VPN_PASSWORDS='密码1 密码2 ...' \ -bash update_vpn_users.sh +bash updatevpnusers.sh ``` ## 手动管理 VPN 用户 diff --git a/docs/manage-users.md b/docs/manage-users.md index ce7d5ce..48ede0e 100644 --- a/docs/manage-users.md +++ b/docs/manage-users.md @@ -42,57 +42,86 @@ For IPsec/XAuth ("Cisco IPsec"), VPN users are specified in `/etc/ipsec.d/passwd ## Manage VPN users using helper scripts -You may use these scripts to more easily manage VPN users: [add_vpn_user.sh](../extras/add_vpn_user.sh), [del_vpn_user.sh](../extras/del_vpn_user.sh) and [update_vpn_users.sh](../extras/update_vpn_users.sh). They will update users for both IPsec/L2TP and IPsec/XAuth ("Cisco IPsec"). Replace command parameters below with your own values. For IKEv2, see [Manage client certificates](ikev2-howto.md#manage-client-certificates). +You may use helper scripts to [add](../extras/add_vpn_user.sh), [delete](../extras/del_vpn_user.sh) or [update all](../extras/update_vpn_users.sh) VPN users for both IPsec/L2TP and IPsec/XAuth ("Cisco IPsec") modes. For IKEv2 mode, please instead see [Manage client certificates](ikev2-howto.md#manage-client-certificates). -**Note:** VPN users are stored in `/etc/ppp/chap-secrets` and `/etc/ipsec.d/passwd`. The scripts will backup these files before making changes, with `.old-date-time` suffix. +**Note:** Replace command arguments below with your own values. VPN users are stored in `/etc/ppp/chap-secrets` and `/etc/ipsec.d/passwd`. The scripts will backup these files before making changes, with `.old-date-time` suffix. ### Add or edit a VPN user Add a new VPN user, or update an existing VPN user with a new password. +Run the script and follow the prompts: + ```bash -# Download the script -wget -nv -O add_vpn_user.sh https://bit.ly/addvpnuser -# Run the script and follow the prompts -sudo bash add_vpn_user.sh +sudo addvpnuser.sh ``` +
+ +Error: "sudo: addvpnuser.sh: command not found". + + +This is normal if you used an older version of the VPN setup script. First, download the helper script: + +```bash +wget -nv -O /opt/src/addvpnuser.sh https://bit.ly/addvpnuser +chmod +x /opt/src/addvpnuser.sh && ln -s /opt/src/addvpnuser.sh /usr/bin +``` + +Then run the script using the instructions. +
+ Alternatively, you can run the script with arguments: ```bash # All values MUST be placed inside 'single quotes' # DO NOT use these special characters within values: \ " ' -sudo bash add_vpn_user.sh 'username_to_add' 'password' +sudo addvpnuser.sh 'username_to_add' 'password' # OR -sudo bash add_vpn_user.sh 'username_to_update' 'new_password' +sudo addvpnuser.sh 'username_to_update' 'new_password' ``` ### Delete a VPN user Delete the specified VPN user. +Run the script and follow the prompts: + ```bash -# Download the script -wget -nv -O del_vpn_user.sh https://bit.ly/delvpnuser -# Run the script and follow the prompts -sudo bash del_vpn_user.sh +sudo delvpnuser.sh ``` +
+ +Error: "sudo: delvpnuser.sh: command not found". + + +This is normal if you used an older version of the VPN setup script. First, download the helper script: + +```bash +wget -nv -O /opt/src/delvpnuser.sh https://bit.ly/delvpnuser +chmod +x /opt/src/delvpnuser.sh && ln -s /opt/src/delvpnuser.sh /usr/bin +``` + +Then run the script using the instructions. +
+ Alternatively, you can run the script with arguments: ```bash # All values MUST be placed inside 'single quotes' # DO NOT use these special characters within values: \ " ' -sudo bash del_vpn_user.sh 'username_to_delete' +sudo delvpnuser.sh 'username_to_delete' ``` ### Update all VPN users Remove all existing VPN users and replace with the list of users you specify. +First, download the script: + ```bash -# Download the script -wget -nv -O update_vpn_users.sh https://bit.ly/updatevpnusers +wget -nv -O updatevpnusers.sh https://bit.ly/updatevpnusers ``` To use this script, choose one of the following options: @@ -102,9 +131,9 @@ To use this script, choose one of the following options: **Option 1:** Edit the script and enter VPN user details: ```bash -nano -w update_vpn_users.sh +nano -w updatevpnusers.sh [Replace with your own values: YOUR_USERNAMES and YOUR_PASSWORDS] -sudo bash update_vpn_users.sh +sudo bash updatevpnusers.sh ``` **Option 2:** Define VPN user details as environment variables: @@ -116,7 +145,7 @@ sudo bash update_vpn_users.sh sudo \ VPN_USERS='username1 username2 ...' \ VPN_PASSWORDS='password1 password2 ...' \ -bash update_vpn_users.sh +bash updatevpnusers.sh ``` ## Manually manage VPN users