下载安装包后里面的readme文档有详细的安装配置介绍，我这里直接抄袭：

#### 安装

首先，从github上下载，可以直接利用git clone，也可以下载压缩包自己解压然后安装。下面以git为例，如果没有则需要先安装：

```bash
# Ubuntu/Debian
sudo apt-get install git# ArchLinux
sudo pacman -S git
```

然后，从项目中clone下来并安装

```bash
git clone git://github.com/humiaozuzu/YaH3C.git
cd YaH3C
sudo python setup.py install
```

ArchLinux默认安装的python是python3，你需要手动安装python2。

#### 使用

完整的联网过程有2步，首先使用本客户端通过交换机的认证，然后获取ip。

认证

程序运行时必须要有root权限：

```bash
sudo yah3c
```

根据程序的提示输入账号密码就可以开始认证了，有些选项如果看不懂请直接按Enter。

获取ip

因为YaH3C仅仅是认证客户端，所以通过认证后你需要自己获取ip联网，不过为了方便还是添加了dhcp支持。

如果没有指定dhcp的命令，你可以在认证成功后使用自己喜欢的网络管理工具获取IP，如NetworkManager或Wicd。

YaH3C支持基本的命令行参数，执行yah3c -h可以看到支持的命令行参数

``` bash
$ yah3c -h
usage: yah3c [-h] [-u USERNAME] [-debug]

Yet Another H3C Authentication Client

optional arguments:
-h, --help show this help message and exit
-u USERNAME, --username USERNAME
Login in with this username
-debug Enable debugging mode
```

如执行sudo yah3c -u Maple可以自动认证Maple这个帐号

配置文件格式

用户的登陆信息按照如下的格式保存在文件/etc/yah3c.conf中：

``` ini
[account]                  # 你的帐户
password = 123456          # 密码
ethernet_interface = eth0  # 使用的网卡，默认为eth0
dhcp_command = dhcpcd      # 验证成功后使用的dhcp命令(dhcpcd/dhclient)，默认为空
daemon = True              # 验证成功后是否变成daemon进程，默认为是

使用的截图如下：

容易出现的两个问题：

1. 显示获取不到ip的错误，这时,你应该把自动获取密码改成手动获取密码：

[linchw3]
password = 《不给你看》
ethernet_interface = eth0
dhcp_command = dhclient   //改这里改成dhclient
daemon = True

2. 直接找不到设备，这种情况在Ubuntu16.04以上会遇到，这是因为新版的Ubuntu把默认网卡名字改了，不是eth0了，把网卡名字改一下就好