mirror of
https://github.com/go-i2p/goSam.git
synced 2025-06-07 09:03:33 -04:00
325 lines
7.8 KiB
HTML
325 lines
7.8 KiB
HTML
<html>
|
|
<head>
|
|
<title>
|
|
goSam
|
|
</title>
|
|
<meta name="author" content="eyedeekay" />
|
|
<meta name="description" content="goSam" />
|
|
<meta name="keywords" content="master" />
|
|
<link rel="stylesheet" type="text/css" href="style.css" />
|
|
<link rel="stylesheet" type="text/css" href="showhider.css" />
|
|
</head>
|
|
<body>
|
|
<div id="navbar">
|
|
<a href="#shownav">
|
|
Show navigation
|
|
</a>
|
|
<div id="shownav">
|
|
<div id="hidenav">
|
|
<ul>
|
|
<li>
|
|
<a href="..">
|
|
Up one level ^
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="index.html">
|
|
index
|
|
</a>
|
|
</li>
|
|
<li>
|
|
<a href="CONTRIBUTING.html">
|
|
CONTRIBUTING
|
|
</a>
|
|
</li>
|
|
</ul>
|
|
<br>
|
|
<a href="#hidenav">
|
|
Hide Navigation
|
|
</a>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<a id="returnhome" href="/">
|
|
/
|
|
</a>
|
|
<h1>
|
|
goSam
|
|
</h1>
|
|
<p>
|
|
A go library for using the
|
|
<a href="https://geti2p.net/en/">
|
|
I2P
|
|
</a>
|
|
Simple Anonymous
|
|
Messaging (
|
|
<a href="https://geti2p.net/en/docs/api/samv3">
|
|
SAM version 3.0
|
|
</a>
|
|
) bridge. It
|
|
has support for all streaming features SAM version 3.2.
|
|
</p>
|
|
<p>
|
|
STATUS: This project is maintained. I will respond to issues, pull requests, and feature requests within a few days. I am primarily maintaining functionality. This is widely used and easy to use, but thusfar, mostly by me. It sees a lot of testing and no breaking changes to the API are expected.
|
|
</p>
|
|
<h2>
|
|
Installation
|
|
</h2>
|
|
<pre><code>go get github.com/eyedeekay/goSam
|
|
</code></pre>
|
|
<h2>
|
|
Using it for HTTP Transport
|
|
</h2>
|
|
<p>
|
|
<code>
|
|
Client.Dial
|
|
</code>
|
|
implements
|
|
<code>
|
|
net.Dial
|
|
</code>
|
|
so you can use go’s library packages like http.
|
|
</p>
|
|
<pre><code class="language-go">package main
|
|
|
|
import (
|
|
"io"
|
|
"log"
|
|
"net/http"
|
|
"os"
|
|
|
|
"github.com/cryptix/goSam"
|
|
)
|
|
|
|
func main() {
|
|
// create a default sam client
|
|
sam, err := goSam.NewDefaultClient()
|
|
checkErr(err)
|
|
|
|
log.Println("Client Created")
|
|
|
|
// create a transport that uses SAM to dial TCP Connections
|
|
tr := &http.Transport{
|
|
Dial: sam.Dial,
|
|
}
|
|
|
|
// create a client using this transport
|
|
client := &http.Client{Transport: tr}
|
|
|
|
// send a get request
|
|
resp, err := client.Get("http://stats.i2p/")
|
|
checkErr(err)
|
|
defer resp.Body.Close()
|
|
|
|
log.Printf("Get returned %+v\n", resp)
|
|
|
|
// create a file for the response
|
|
file, err := os.Create("stats.html")
|
|
checkErr(err)
|
|
defer file.Close()
|
|
|
|
// copy the response to the file
|
|
_, err = io.Copy(file, resp.Body)
|
|
checkErr(err)
|
|
|
|
log.Println("Done.")
|
|
}
|
|
|
|
func checkErr(err error) {
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
}
|
|
|
|
</code></pre>
|
|
<h3>
|
|
Using SAM by default, as a proxy for all HTTP Clients used by a Go application
|
|
</h3>
|
|
<p>
|
|
This will make the SAM transport dialer the default for all HTTP clients.
|
|
</p>
|
|
<pre><code class="language-go">package main
|
|
|
|
import (
|
|
"io"
|
|
"log"
|
|
"net/http"
|
|
"os"
|
|
|
|
"github.com/cryptix/goSam"
|
|
)
|
|
|
|
func main() {
|
|
sam, err := goSam.NewDefaultClient()
|
|
checkErr(err)
|
|
|
|
log.Println("Client Created")
|
|
|
|
// create a transport that uses SAM to dial TCP Connections
|
|
httpClient := &http.Client{
|
|
Transport: &http.Transport{
|
|
Dial: sam.Dial,
|
|
},
|
|
}
|
|
|
|
http.DefaultClient = httpClient
|
|
return nil
|
|
}
|
|
|
|
func checkErr(err error) {
|
|
if err != nil {
|
|
log.Fatal(err)
|
|
}
|
|
}
|
|
</code></pre>
|
|
<h2>
|
|
Using it as a SOCKS proxy
|
|
</h2>
|
|
<p>
|
|
<code>
|
|
client
|
|
</code>
|
|
also implements a resolver compatible with
|
|
<a href="https://github.com/getlantern/go-socks5">
|
|
<code>
|
|
getlantern/go-socks5
|
|
</code>
|
|
</a>
|
|
,
|
|
making it very easy to implement a SOCKS5 server.
|
|
</p>
|
|
<pre><code class="language-go">package main
|
|
|
|
import (
|
|
"flag"
|
|
|
|
"github.com/eyedeekay/goSam"
|
|
"github.com/getlantern/go-socks5"
|
|
"log"
|
|
)
|
|
|
|
var (
|
|
samaddr = flag.String("sam", "127.0.0.1:7656", "SAM API address to use")
|
|
socksaddr = flag.String("socks", "127.0.0.1:7675", "SOCKS address to use")
|
|
)
|
|
|
|
func main() {
|
|
sam, err := goSam.NewClient(*samaddr)
|
|
if err != nil {
|
|
panic(err)
|
|
}
|
|
log.Println("Client Created")
|
|
|
|
// create a transport that uses SAM to dial TCP Connections
|
|
conf := &socks5.Config{
|
|
Dial: sam.DialContext,
|
|
Resolver: sam,
|
|
}
|
|
server, err := socks5.New(conf)
|
|
if err != nil {
|
|
panic(err)
|
|
}
|
|
|
|
// Create SOCKS5 proxy on localhost port 8000
|
|
if err := server.ListenAndServe("tcp", *socksaddr); err != nil {
|
|
panic(err)
|
|
}
|
|
}
|
|
</code></pre>
|
|
<h3>
|
|
.deb package
|
|
</h3>
|
|
<p>
|
|
A package for installing this on Debian is buildable, and a version for Ubuntu
|
|
is available as a PPA and mirrored via i2p. To build the deb package, from the
|
|
root of this repository with the build dependencies installed(git, i2p, go,
|
|
debuild) run the command
|
|
</p>
|
|
<pre><code> debuild -us -uc
|
|
</code></pre>
|
|
<p>
|
|
to produce an unsigned deb for personal use only. For packagers,
|
|
</p>
|
|
<pre><code> debuild -S
|
|
</code></pre>
|
|
<p>
|
|
will produce a viable source package for use with Launchpad PPA’s and other
|
|
similar systems.
|
|
</p>
|
|
<h3>
|
|
TODO
|
|
</h3>
|
|
<ul>
|
|
<li>
|
|
Improve recovery on failed sockets
|
|
</li>
|
|
<li>
|
|
Implement
|
|
<code>
|
|
STREAM FORWARD
|
|
</code>
|
|
</li>
|
|
<li>
|
|
Implement datagrams (Repliable and Anon)
|
|
</li>
|
|
</ul>
|
|
<div id="sourcecode">
|
|
<span id="sourcehead">
|
|
<strong>
|
|
Get the source code:
|
|
</strong>
|
|
</span>
|
|
<ul>
|
|
<li>
|
|
<a href="https://github.com/eyedeekay/goSam">
|
|
Source Repository: (https://github.com/eyedeekay/goSam)
|
|
</a>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
<div>
|
|
<a href="#show">
|
|
Show license
|
|
</a>
|
|
<div id="show">
|
|
<div id="hide">
|
|
<pre><code>The MIT License (MIT)
|
|
|
|
Copyright (c) 2014 Henry
|
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
in the Software without restriction, including without limitation the rights
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
furnished to do so, subject to the following conditions:
|
|
|
|
The above copyright notice and this permission notice shall be included in all
|
|
copies or substantial portions of the Software.
|
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
SOFTWARE.
|
|
|
|
</code></pre>
|
|
<a href="#hide">
|
|
Hide license
|
|
</a>
|
|
</div>
|
|
</div>
|
|
</div>
|
|
<div>
|
|
<iframe src="https://snowflake.torproject.org/embed.html" width="320" height="240" frameborder="0" scrolling="no"></iframe>
|
|
</div>
|
|
<div>
|
|
<a href="https://geti2p.net/">
|
|
<img src="i2plogo.png"></img>
|
|
I2P
|
|
</a>
|
|
</div>
|
|
</body>
|
|
</html> |