欢迎使用

欢迎来到Charles。这个文档是个一个正在进行中的工作。如果你在这没有找到你的答案，请联系我们。

Charles目标是成为一个潜入软件。开启这个软件，，它会尝试自动配置你的浏览器，所以你能马上准备好并且开始运行。开始浏览web并且查看再Charles中返回的结果；点击他们并且观察被记录了什么。

如果要继续阅读，请看右边的目录列表部分。

安装

安装Charles

首先下载Charles，下载地址->charles.如果你使用Firework，请同时下载Firework插件。

Windows

运行安装程序，把Charles安装在你的程序菜单中。

Mac OS X

双击下载文件，将其解压缩，然后复制Charles应用程序复制到到你的应用程序文件夹中。

Linux

Charles具有APT和YUM的存储库，如果您具有基于Debian或基于Red Hat的Linux发行版，则这是安装Charles的首选方式。

否则，将tar.gz归档文件解压到一个合适的位置。如果你之前已经安装过Charles并且正在执行更新操作；首先确保Charles不在运行状态，然后在以前安装的头文件进行安装或者复制。通过运行bin/Charles脚本开启Charles。

开始使用

请查看开始使用指导（下一部分）来开始使用Charles！

APT存储库

Charles有一个用于基于Debian的Linux发行版的ATP存储库。

注：为了利用更大的密钥和更强的汇编，，回购协议的密钥已于2016.7.26发生了改变。ATP存储库中已经出现的用户需要导入新的公共密钥。新的公共密钥和旧的公共密钥在同一个URL地址，因此重复下面的apt-key添加步骤来添加它。最后运行apt-get update来运行新的密钥。

首先为存储库安装GPG公共密钥，因此你可以确认这个软件包是否签名正确。
现在的公钥id是AD28806并且它的指纹是4BA7 DB85 7B57 0089 7420 96E1 5F16 B97C 1AD2 8806:

wget -q -O - https://www.charlesproxy.com/packages/apt/PublicKey | sudo apt-key add -

或者可替换为：

sudo apt-key adv --keyserver pgp.mit.edu --recv-keys 1AD28806

然后把存储库安装到你的资源中：

sudo sh -c 'echo deb https://www.charlesproxy.com/packages/apt/ charles-proxy main > /etc/apt/sources.list.d/charles.list'

然后更新你的源代码并且安装Charles：

sudo apt-get update
sudo apt-get install charles-proxy

这个包在/user/bin中创建了一个“charles”命令，并且把Charles添加到 窗口管理器的应用程序菜单中。

你也可能安装Charles的一个被称为charles代理测试版的测试轨道。

APT存储库

使用charles-proxy3的安装包来安装Charles 3。你可以同时安装Charles 4和Charles 3。

这个包在/user/bin中创建了一个“charles3”命令，并且把Charles添加到窗口管理器的应用程序菜单中。

YUM存储库

Charles有一个用于基于Red Hat的Linux发行版的YUM仓库。

cat <<EOF > /etc/yum.repos.d/Charles.repo
[charlesproxy]name=Charles Proxy Repository
baseurl=https://www.charlesproxy.com/packages/yum
gpgkey=https://www.charlesproxy.com/packages/yum/PublicKey
EOF

然后安装Charles：

sudo yum install charles-proxy

这个包在/user/bin中创建了一个“charles”命令，并且把Charles添加到窗口管理器的应用程序菜单中。

你也可能安装Charles的一个被称为charles代理测试版的测试轨道。

（注：charles-proxy-beta、charles-proxy-beta、Red Hat、Red Hat需了解）

准备开始

学习怎样使用Charles和它可以怎样帮助你最好的办法是安装它并且观察他是怎样工作的。如果你还没有准备好请看上方安装的部分。

开始使用Charles

通过你的“开始”菜单、“应用程序”文件夹或者任何你安装Charles的地方运行该应用程序来启动Charles。

如果你已经安装了Firefox，你将会被询问一个关于Firefox附加组件的问题。这个让你告诉Charles你是否已经安装了Firefox附加组件或者没有安装。

在Mac OS X上你将被会问到一个关于你的Mac OS X代理设置的问题。为了能够在Mac OS X自动配置你的代理设置你需要通过输入密码来授予Charles权限。

你可以对这两个问题回答“还没有（Not Yet)”，稍后完成后你将获得开始使用Charles的机会。

第一印象

你最先看到的东西是一个未命题的会话。如果你的代理设置已经被自动配置，你现在应该可以使用你的web浏览器并且观察已经被记录在Charles中的事件。

你会看到你所访问的每一个网站/主机的节点都显示在左边的树中。探索这棵树。点击某一个已经被记录的事件，你会在正文（body）中看到详细信息（可能仅仅在响应的选项卡上，除非你正在执行POST），并且你会看到正在传输的数据。

这是你可以用Charles做的最简单、最普通的事。它具有强大的功能，因为你可以看到正在传输和接收的每一个内容——它使你可以深入了解实际发生的事情。

配置