diff --git a/MacOSXConfig.md b/MacOSXConfig.md
new file mode 100644
index 0000000..7af68b9
--- /dev/null
+++ b/MacOSXConfig.md
@@ -0,0 +1,27 @@
+# MacOSX运行FastGithub配置教程
+
+### 1 解决 "XXX" cannot be opened because the developer cannot be verified
+打开终端进入FastGithub执行文件所在路径执行命令：
+sudo xattr -d com.apple.quarantine XXX
+
+### 2 安装证书
+打开FastGithub后，目录内会生成cacert目录，双击打开fastgithub.cer，系统弹出Keychain Access窗口，列表中双击FastGitHub，弹出证书详情窗口，展开Trust并选择Always Trust。
+
+<img src="https://github.com/dotnetcore/FastGithub/blob/master/Resources/MacOSXConfig/KeychainAccess.png?raw=true"/>
+
+<img src="https://github.com/dotnetcore/FastGithub/blob/master/Resources/MacOSXConfig/trust.png?raw=true"/>
+
+### 3 配置代理
+#### 3.1 自动代理
+打开mac设置，网络，点击高级，选择代理，勾选网自动代理配置，填写FastGithub窗口提示的地址
+
+<img src="https://github.com/dotnetcore/FastGithub/blob/master/Resources/MacOSXConfig/autoproxy.png?raw=true"/>
+
+<img src="https://github.com/dotnetcore/FastGithub/blob/master/Resources/MacOSXConfig/cmdwin.png?raw=true"/>
+
+#### 3.2 手动代理
+打开mac设置，网络，点击高级，选择代理，勾选网页代理(HTTP)及安全网页代理(HTTPS),填写FastGithub窗口提示的地址
+
+<img src="https://github.com/dotnetcore/FastGithub/blob/master/Resources/MacOSXConfig/proxy.png?raw=true"/>
+
+<img src="https://github.com/dotnetcore/FastGithub/blob/master/Resources/MacOSXConfig/cmdwin.png?raw=true"/>
\ No newline at end of file
diff --git a/README.md b/README.md
index c76f2e4..7071639 100644
--- a/README.md
+++ b/README.md
@@ -19,6 +19,7 @@ github加速神器，解决github打不开、用户头像无法加载、releases
 * 双击运行fastgithub程序
 * 安装cacert/fastgithub.cer并设置信任
 * 设置系统自动代理为`http://127.0.0.1:38457`，或手动代理http/https为`127.0.0.1:38457`
+* [具体配置详情](https://github.com/dotnetcore/FastGithub/blob/master/MacOSXConfig.md)
 
 ### 3 加速原理
 #### 3.1 windows
diff --git a/Resources/MacOSXConfig/KeychainAccess.png b/Resources/MacOSXConfig/KeychainAccess.png
new file mode 100644
index 0000000..87a422f
Binary files /dev/null and b/Resources/MacOSXConfig/KeychainAccess.png differ
diff --git a/Resources/MacOSXConfig/autoproxy.png b/Resources/MacOSXConfig/autoproxy.png
new file mode 100644
index 0000000..b8e6d10
Binary files /dev/null and b/Resources/MacOSXConfig/autoproxy.png differ
diff --git a/Resources/MacOSXConfig/cmdwin.png b/Resources/MacOSXConfig/cmdwin.png
new file mode 100644
index 0000000..f40d8fc
Binary files /dev/null and b/Resources/MacOSXConfig/cmdwin.png differ
diff --git a/Resources/MacOSXConfig/proxy.png b/Resources/MacOSXConfig/proxy.png
new file mode 100644
index 0000000..644e423
Binary files /dev/null and b/Resources/MacOSXConfig/proxy.png differ
diff --git a/Resources/MacOSXConfig/trust.png b/Resources/MacOSXConfig/trust.png
new file mode 100644
index 0000000..ce323e6
Binary files /dev/null and b/Resources/MacOSXConfig/trust.png differ