Updated Getting Started (markdown)

Leonid Bugaev
2016-05-16 16:50:39 +05:00
parent 2f16590b3a
commit 634ac8c8aa
+6 -6
@@ -1,12 +1,12 @@
## Dependencies
### Dependencies
To start working with Gor, you need to have a web server running on your machine and terminal to run commands. If you are just poking around, you can quickly start the server by calling `python -m SimpleHTTPServer 8000`, this will start simple file server of the current directory on port `8000`.
## Installing Gor
### Installing Gor
Download the latest Gor binary from https://github.com/buger/gor/releases (we provide precompiled binaries for Linux x64 and Mac OS), or you can compile by yourself [[Compilation]].
Once the archive is downloaded and uncompressed, you run Gor from the current directory, or you may want to copy binary to your PATH (for Linux and Mac OS it can be `/usr/local/bin`).
## Capturing web traffic
### Capturing web traffic
Now run this command in terminal: `sudo ./gor --input-raw :8000 --output-dummy=""`
This command says to listen for all network activity happening on port 8000 and log it to stdout.
@@ -21,7 +21,7 @@ Make a few requests by opening `http://localhost:8000` in your browser, or just
**Gor is not a proxy;** you do not need to put 3-rd party tool to your critical path. Instead Gor just silently analyzes the traffic of your application and do not affect it anyhow.
## Replaying
### Replaying
Now it's time to replay your original traffic to another environment. Let's start same file web server but on a different port: `python -m SimpleHTTPServer 8001`.
@@ -29,7 +29,7 @@ Instead of `--output-dummy` we will use `--output-http` and provide URL of secon
Make few requests to first server. You should see them replicated to the second one, voila!
## Saving requests to file and replaying them later
### Saving requests to file and replaying them later
Sometimes it's not possible to replay requests in real time; Gor allows you save requests to the file and replay them later.
First use `--output-file` to save them: `sudo ./gor --input-raw :8000 --output-file=requests.gor`. This will create new file and continiously write all captured requests to it.
@@ -38,7 +38,7 @@ Let's re-run Gor, and run again but now it will replay requests from file: `./go
Next: [[The Basics]]
## Watch an overview:
### Watch an overview:
[![Foo](http://img.youtube.com/vi/CxuKZcMKaW4/0.jpg)](https://www.youtube.com/watch?v=CxuKZcMKaW4)