Charles抓包教程

Charles抓包教程

0 概述

• 文档内容：主要描述使用Charles工具抓取移动端APP与服务器传输数据的操作教程。
• 文档用途：支持游戏开发者学习Charles抓包，辅助SDK接入问题排查和反馈。

1 关键定义

• Charles： PC 端网络封包截取工具，可用于截取移动端APP与服务器端网络通讯协议内容。
• 抓包：packet capture，将网络传输发送与接收的数据包进行截获、重发、编辑、转存等操作。

2 安装Charles

2.1 下载Charles安装包

• 下载地址：http://www.charlesproxy.com

2.2 试用与激活

试用规则：基本可满足SDK常规问题抓包需求。

• 30天内：免费试用，使用时长无限制；
• 30天后：限制使用，使用时长受限制，每30分钟提示并重启一次。

激活方式：

• 操作入口：Charles菜单栏->“Help”->“Registered Charles...”
• 配置内容：输入Registered name和License key。

3 配置 Charles

3.1 配置代理

• 操作入口：Charles菜单栏-> “Proxy”->”Proxy Settings”->“Proxies”
• 配置内容：
  • Port：代理端口值，默认填入8888，或者自定义，前提是不能和系统已占用端口冲突。
  • Enable transparent HTTP proxying：勾上。

image

3.2 安装证书

• 操作入口：点击 Charles 的菜单栏-> “Help”->”SSL Settings”->“Install Charles Root Certificate”，并将Charles证书“添加”到登录钥匙串，再进入“钥匙串访问”页面。

image

image

• 操作入口：登录钥匙串->Charles证书->信任->使用此证书时
• 配置内容：选择“始终信任”，并关闭证书详情，需要输入电脑密码确认更新设置。

image

image

• Windows电脑注意事项：
  • 安装证书时，存储位置选择“本地计算机”，证书存储选择“受信任的根证书颁发机构”。

image

image

image

image

3.3 设置SSL代理和抓取域名

• 操作入口：Charles 的菜单栏-> “Proxy”->“SSL Proxying Settings”-> “SSL Proxying”
• 配置内容：
  • Enable SSL Proxying：勾上，即开启SSL代理。
  • 添加Location：点击下方“Add”，在Host输入“*”，即设定为抓取全量域名请求。

image

image

4 配置手机

4.1 连接代理

注意事项****：

• 确保手机连接的无线网络与电脑一致，并且手机没有连接VPN。

4.1.1 获取代理服务器地址和端口

• 操作入口：Charles 的菜单栏-> “Help”->“SSL Proxying”->“Install Charles Root Certificate on a Mobile Device or Remote Browser”
• 获取内容：如下图示例，服务器地址为10.90.153.229，端口为8888。

image

image

4.1.2 手机连接WiFi代理

• 注意事项：

  • 确保手机连接的无线网络与电脑一致，并且手机没有连接VPN。
  • 下文以Apple iOS系统为例介绍配置，安卓手机修改方式大同小异，可自行探索，主要是开启手动代理，并设置代理服务器地址和端口。

• 操作入口：设置->WiFi无线局域网->进入对应WiFi详情->配置代理

• 配置内容：完成以下配置并“存储”。

  • 手动：勾选
  • 服务器：填写按照上文「4.1.1 获取代理服务器地址和端口」获取的服务器地址。
  • 端口：填写按照上文「4.1.1 获取代理服务器地址和端口」获取的端口。

• 示例

image

image

image

image

4.2 安装Charles证书

• 方法一：

1. 联网：手机已按照上文「4.1.2 手机连接WiFi代理」连接网络。
2. 下载：使用手机默认浏览器safari，访问地址chls.pro/ssl，并允许下载证书，安卓手机可尝试使用chrome浏览器。
3. 安装：在“设置->已下载描述文件-安装”，安装Charles证书。
4. 信任：在“设置->通用->关于本机->证书信任设置(滑到最下面)”，开启对Charles证书信任。
5. iOS示例：

image

image

image

image

• 方法二：如果方法一不能成功安装，使用导入安装。

  • 获取证书：点击 Charles 菜单栏-> Help->SSL Proxying –> Save Charles Root Certificate ，选择pem格式，下载到电脑。
  • 安装证书：将证书导入到手机，点击安装即可。

• 安卓手机安装证书常见问题：

  • 无法安装：下载证书后直接点击会报错“无法安装”（如小米MIUI），可在系统设置里搜索“安装证书”，找到后选择刚下载的证书进行安装。
  • 找不到证书：在网络中选择高级设置/安全选项中，点击安装证书，找到下载证书位置并安装。

• 手机无法访问chls.pro/ssl问题：

  • 确保手机未开启VPN，并与电脑使用同一个无线网络；
  • PC若为windows系统，需要关闭Windows防火墙。

5 抓取数据

• 前置条件：完成上文「2 安装Charles」「3 配置Charles」「4 配置手机」
• 注意事项：按照上文「3.3 设置SSL代理和抓取域名」设置全量域名抓取。

5.1 操作Charles

• 操作步骤：

1. 进入会话界面：在PC端打开Charles，进入Session界面，如无可在“Charles 菜单栏->File->New Session”新建。
2. 手机端触发请求：在手机启动游戏并等待完成加载，完成你问题的复现步骤，同时观察Session界面是否已出现对应域名。
3. 找到目标数据：
   1. 选择目标域名下的请求，可输入Filter过滤目标域名；
   2. 查看请求信息、响应信息。
4. 反馈问题：如需Ohayoo SDK技术协助排查，请在“Charles 菜单栏->File->Save Session As”保存会话，并反馈给运营或技术支持。

image

5.2 学习更多

• 进阶学习：Charles官网英文文档，Charles功能介绍和使用教程，或自行搜索更多教程。
• 温馨提示：完成抓包后，关闭手机WiFi代理，以免在Charles停止工作时影响手机网络的正常使用。

在为笔记存储，感谢头条对外链接：https://bytedance.feishu.cn/docs/doccn8jNE6gXQTiN5lqU0LjnbLh