# Golang爬虫终极杀器——Chromedp让你成为二维码登陆终结者(教程)
> 1. [Github源码 - chromedp](https://github.com/chromedp/chromedp)
> 2. [文章项目Gitee源码](https://gitee.com/avtion/chromedp-learning)
# 1 Chromedp是什么
`chromedp`是一个`更快`、`更简单`的Golang库用于调用支持`Chrome DevTools协议`的浏览器,同时不需要额外的依赖(例如`Selenium`和`PhantomJS`)
> Chrome和Golang都与Google有着相当密切的关系,而Chrome DevTools其实就是Chrome浏览器按下F12之后的控制终端
# 2 为什么不使用Selenium
对于`Golang`开发来说,使用`chromedp`更为便捷,因为它仅仅需要`Chrome`浏览器而并不需要依赖`ChromeDriver`,省去了依赖问题,有助于自动化的构建和多平台架构的迁移
# 3 文章解决了什么需求
1. 如何使用`chromedp`进行二维码登陆
2. 如何将二维码展示在无图形化的终端上(`makiuchi-d/gozxing`解码 `skip2/ go-qrcode`编码)
3. 如何保存Cookies实现短时间免登陆
> 网站会更新,文章不保证更新,请务必学会举一反三
# 4 如何使用chromedp进行二维码登陆
## 4.1 安装chromedp
1. 下载并安装Chrome浏览器
2. 创建Golang项目,开启`Go Module`(在项目目录下使用终端输入`go mod init`)
3. 在项目目录下使用终端输入:`go get -u github.com/chromedp/chromedp`(如果有依赖问题请删除`-u`)
## 4.2 尝试打开网站(以金山文档`https://account.wps.cn/`为例)
1. 重新设置chromedp使用`"有头"`的方式打开,以便于我们进行`debug`
```golang
func main(){
// chromdp依赖context上限传递参数
ctx, _ := chromedp.NewExecAllocator(
context.Background(),
// 以默认配置的数组为基础,覆写headless参数
// 当然也可以根据自己的需要进行修改,这个flag是浏览器的设置
append(
chromedp.DefaultExecAllocatorOptions[:],
chromedp.Flag("headless", false),
)...,
)
}
```
2. 创建chromedp上下文对象
```golang
func main(){
// chromdp依赖context上限传递参数
...
// 创建新的chromedp上下文对象,超时时间的设置不分先后
// 注意第二个返回的参数是cancel(),只是我省略了
ctx, _ = context.WithTimeout(ctx, 30*time.Second)
ctx, _ = chromedp.NewContext(
ctx,
// 设置日志方法
chromedp.WithLogf(log.Printf),
)
// 通常可以使用 defer cancel() 去取消
// 但是在Windows环境下,我们希望程序能顺带关闭掉浏览器
// 如果不希望浏览器关闭,使用cancel()方法即可
// defer cancel()
// defer chromedp.Cancel(ctx)
}
```
3. 执行自定义的任务
```golang
func main(){
// chromdp依赖context上限传递参数
...
// 创建新的chromedp上下文对象,超时时间的设置不分先后
// 注意第二个返回的参数是cancel(),只是我省略了
...
// 执行我们自定义的任务 - myTasks函数在第4步
if err := chromedp.Run(ctx, myTasks()); err != nil {
log.Fatal(err)
return
}
}
```
4. 至此程序的初始化过程已经完成,接下来就是任务——打开登陆页面
```golang
// 自定义任务
func myTasks() chromedp.Tasks {
return chromedp.Tasks{
// 1. 打开金山文档的登陆界面
chromedp.Navigate(loginURL),
}
}
```
5. 运行一下程序,可以看到Chrome被打开,同时访问了我们指定的网站
![1.png](https://static.studygolang.com/201108/ee2863080128f828eba9da3627d9db36.png)
## 4.3 获取二维码(点击过程)
1. 需要点击`微信登陆`按钮,先找到按钮的`选择器`,右键按钮并在菜单中点击`检查`,然后可以看到按钮的元素
![2.png](https://static.studygolang.com/201108/072a83a45df832a386ab8252c196396a.png)
2. 右键元素打开菜单找到`copy`下的`copy selector`,即获取到`选择器`
![3.png](https://static.studygolang.com/201108/c46eb59178c0e19c2a4a10fbebcdec1e.png)
3. 我们尝试点击微信登陆按钮,发现还需要点击一下确认,重复上述步骤获取`确认按钮`的选择器
![4.png](https://static.studygolang.com/201108/e1ec296379dc57ac86ee9760e6330122.png)
4. 用代码执行上述点击步骤
```golang
// 自定义任务
func myTasks() chromedp.Tasks {
return chromedp.Tasks{
// 1. 打开金山文档的登陆界面
chromedp.Navigate(loginURL),
// 2. 点击微信登陆按钮
// #wechat > span:nth-child(2)
chromedp.Click(`#wechat > span:nth-child(2)`),
// 3. 点击确认按钮
// #dialog > div.dialog-wrapper > div > div.dialog-footer > div.dialog-footer-ok
chromedp.Click(`#dialog > div.dialog-wrapper > div > div.dialog-footer > div.dialog-footer-ok`),
}
}
```
5. 运行程序即可直达二维码展示界面
![5.png](https://static.studygolang.com/201108/788ca2fe1c27c3cbda77a6936342102c.png)
6. 用同样的方式,获取`二维码图片`的`选择器`
![6.png](https://static.studygolang.com/201108/0c85c4dac9bcbc4c22beb2afa4963486.png)
7. 用代码实现获取二维码,有两点需要注意,第一是二维码有加载过程,第二是二维码是元素渲染,我们需要用截图的方式获取(也可以用`js`来获取对应的`href`并下载,但是为了照顾小白,选择最简单的)
```golang
func myTasks() chromedp.Tasks {
return chromedp.Tasks{
// 1. 打开金山文档的登陆界面
...
// 2. 点击微信登陆按钮
...
// 3. 点击确认按钮
...
// 4. 获取二维码
// #wximport
getCode(),
}
}
func getCode() chromedp.ActionFunc {
return func(ctx context.Context) (err error) {
// 1. 用于存储图片的字节切片
var code []byte
// 2. 截图
// 注意这里需要注明直接使用ID选择器来获取元素(chromedp.ByID)
if err = chromedp.Screenshot(`#wximport`, &code, chromedp.ByID).Do(ctx); err != nil {
return
}
// 3. 保存文件
if err = ioutil.WriteFile("code.png", code, 0755); err != nil {
return
}
return
}
}
```
8. 执行程序即可发现目录下已经存储了二维码图片文件,我们可以通过扫描此二维码进行登陆,与浏览器上扫描为同一种效果
![7.png](https://static.studygolang.com/201108/a2ff56e9553edeb38cf9d7f368ce8bb2.png)
## 5. 如何将二维码展示在无图形化的终端上(与chromedp无关,属于额外内容)
1. 在上述步骤中,我们已经获取了二维码,接下来我们需要在终端显示二维码,首先是解码,这里使用[`gozxing`](github.com/makiuchi-d/gozxing)库
```golang
func printQRCode(code []byte) (err error) {
// 1. 因为我们的字节流是图像,所以我们需要先解码字节流
img, _, err := image.Decode(bytes.NewReader(code))
if err != nil {
return
}
// 2. 然后使用gozxing库解码图片获取二进制位图
bmp, err := gozxing.NewBinaryBitmapFromImage(img)
if err != nil {
return
}
// 3. 用二进制位图解码获取gozxing的二维码对象
res, err := qrcode.NewQRCodeReader().Decode(bmp, nil)
if err != nil {
return
}
return
}
```
2. 然后重新编码来输出二维码到终端,这里使用[`go-qrcode`](github.com/skip2/go-qrcode)库
```golang
// 请注意import的库发生了重名
import (
"github.com/makiuchi-d/gozxing"
"github.com/makiuchi-d/gozxing/qrcode"
goQrcode "github.com/skip2/go-qrcode"
)
func printQRCode(code []byte) (err error) {
// 1. 因为我们的字节流是图像,所以我们需要先解码字节流
...
// 2. 然后使用gozxing库解码图片获取二进制位图
...
// 3. 用二进制位图解码获取gozxing的二维码对象
...
// 4. 用结果来获取go-qrcode对象(注意这里我用了库的别名)
qr, err := goQrcode.New(res.String(), goQrcode.High)
if err != nil {
return
}
// 5. 输出到标准输出流
fmt.Println(qr.ToSmallString(false))
return
}
```
3. 修改我们第二步的过程
```golang
func getCode() chromedp.ActionFunc {
return func(ctx context.Context) (err error) {
// 1. 用于存储图片的字节切片
...
// 2. 截图
// 注意这里需要注明直接使用ID选择器来获取元素(chromedp.ByID)
...
// 3. 把二维码输出到标准输出流
if err = printQRCode(code); err != nil {
return err
}
return
}
}
```
3. 运行程序即可查看效果
![8.png](https://static.studygolang.com/201108/8b2290d603ef9bfd6a82bb8b4ebed8a6.png)
# 6. 如何保存Cookies实现短时间免登陆
1. 在上述过程中,我们可以通过二维码扫描登陆,网站会在登陆之后进行跳转,跳转后我们需要保存`cookies`来维持我们的登录状态,代码实现如下
```golang
// 保存Cookies
func saveCookies() chromedp.ActionFunc {
return func(ctx context.Context) (err error) {
// 等待二维码登陆
if err = chromedp.WaitVisible(`#app`, chromedp.ByID).Do(ctx); err != nil {
return
}
// cookies的获取对应是在devTools的network面板中
// 1. 获取cookies
cookies, err := network.GetAllCookies().Do(ctx)
if err != nil {
return
}
// 2. 序列化
cookiesData, err := network.GetAllCookiesReturns{Cookies: cookies}.MarshalJSON()
if err != nil {
return
}
// 3. 存储到临时文件
if err = ioutil.WriteFile("cookies.tmp", cookiesData, 0755); err != nil {
return
}
return
}
}
```
2. 获取到Cookies之后,我们需要在程序运行时将Cookies从临时文件中加载到浏览器中
```golang
// 加载Cookies
func loadCookies() chromedp.ActionFunc {
return func(ctx context.Context) (err error) {
// 如果cookies临时文件不存在则直接跳过
if _, _err := os.Stat("cookies.tmp"); os.IsNotExist(_err) {
return
}
// 如果存在则读取cookies的数据
cookiesData, err := ioutil.ReadFile("cookies.tmp")
if err != nil {
return
}
// 反序列化
cookiesParams := network.SetCookiesParams{}
if err = cookiesParams.UnmarshalJSON(cookiesData); err != nil {
return
}
// 设置cookies
return network.SetCookies(cookiesParams.Cookies).Do(ctx)
}
}
```
3. 通过上述两步我们已经可以保持登陆状态,然后我们需要检查一下是否成功,这里调用浏览器执行`js`脚本获取当前页面的网址,判断是否已经个人中心页面,如果为真,则停止操作
```golang
// 检查是否登陆
func checkLoginStatus() chromedp.ActionFunc {
return func(ctx context.Context) (err error) {
var url string
if err = chromedp.Evaluate(`window.location.href`, &url).Do(ctx); err != nil {
return
}
if strings.Contains(url, "https://account.wps.cn/usercenter/apps") {
log.Println("已经使用cookies登陆")
chromedp.Stop()
}
return
}
}
```
4. 最终重新设置我们的浏览器任务即可
```golang
// 自定义任务
func myTasks() chromedp.Tasks {
return chromedp.Tasks{
// 0. 加载cookies <-- 变动
loadCookies(),
// 1. 打开金山文档的登陆界面
...
// 判断一下是否已经登陆 <-- 变动
checkLoginStatus(),
// 2. 点击微信登陆按钮
// #wechat > span:nth-child(2)
...
// 3. 点击确认按钮
// #dialog > div.dialog-wrapper > div > div.dialog-footer > div.dialog-footer-ok
...
// 4. 获取二维码
// #wximport
...
// 5. 若二维码登录后,浏览器会自动跳转到用户信息页面 <-- 变动
saveCookies(),
}
}
```
5. 我们使用`已经登陆的cookies`运行程序可以发现我们成功跳过登陆过程
![9.png](https://static.studygolang.com/201108/687f6f0d8f70569a92dd7e98d91d6ee4.png)
panic: exec: "google-chrome": executable file not found in %PATH%
报错 咋回事 添加了:
chromedp.ExecPath("D:/Program Files (x86)/Google/Chrome/Application/chrome.exe") 这个还是没用
#1