README
¶
TeRaSu (TRS)
よの光遍く空へ照しつつ
土棲むものは孰れか見ゆや
Usage
tls.Client(terasu.NewConn(conn), &tls.Config{
ServerName: host,
}).Handshake()
Custom Plugin
Custom plugin code is located in the ext/custom directory. You can write and build your own plugin.
- Write your plugin code in the
ext/customdirectory - Build the plugin:
go build -o terasu.plugin.so -buildmode=plugin -ldflags="-s -w" -trimpath ./ext/custom
Example 1. Build for OpenWrt arm64
sudo apt-get update
sudo apt-get install -y build-essential module-assistant gcc-9-multilib-i686-linux-gnu g++-9-multilib-i686-linux-gnu
wget -nv https://downloads.openwrt.org/releases/23.05.3/targets/ipq807x/generic/openwrt-sdk-23.05.3-ipq807x-generic_gcc-12.3.0_musl.Linux-x86_64.tar.xz
tar -xJf openwrt-sdk-23.05.3-ipq807x-generic_gcc-12.3.0_musl.Linux-x86_64.tar.xz
mv openwrt-sdk-23.05.3-ipq807x-generic_gcc-12.3.0_musl.Linux-x86_64 op23053-ipq807x
rm openwrt-sdk-23.05.3-ipq807x-generic_gcc-12.3.0_musl.Linux-x86_64.tar.xz
PATH=$PATH:`pwd`/op23053-ipq807x/staging_dir/toolchain-aarch64_cortex-a53_gcc-12.3.0_musl/bin/
export PATH
export STAGING_DIR=`pwd`/op23053-ipq807x/staging_dir/toolchain-aarch64_cortex-a53_gcc-12.3.0_musl/
export CGO_CFLAGS=$CGO_CFLAGS" -fuse-ld=bfd"
echo $CGO_CFLAGS
export CGO_LDFLAGS=$CGO_LDFLAGS" -fuse-ld=bfd"
echo $CGO_LDFLAGS
export GOGCCFLAGS=$GOGCCFLAGS" -fuse-ld=bfd"
echo $GOGCCFLAGS
CGO_ENABLED=1 GOOS=linux GOARCH=arm64 GOARM=8 CC=aarch64-openwrt-linux-gcc CXX=aarch64-openwrt-linux-g++ AR=aarch64-openwrt-linux-ar go build -o terasu.plugin.so -buildmode=plugin -ldflags="-s -w" -trimpath ./ext/custom
Documentation
¶
Index ¶
- Variables
- type Conn
- func (conn *Conn) Close() error
- func (conn *Conn) LocalAddr() net.Addr
- func (conn *Conn) Read(b []byte) (int, error)
- func (conn *Conn) ReadFrom(r io.Reader) (n int64, err error)
- func (conn *Conn) RemoteAddr() net.Addr
- func (conn *Conn) SetDeadline(t time.Time) error
- func (conn *Conn) SetReadDeadline(t time.Time) error
- func (conn *Conn) SetWriteDeadline(t time.Time) error
- func (conn *Conn) Write(b []byte) (int, error)
- func (conn *Conn) WriteTo(w io.Writer) (int64, error)
Constants ¶
This section is empty.
Variables ¶
View Source
var DefaultFirstFragmentLen = 4
DefaultFirstFragmentLen ...
Functions ¶
This section is empty.
Types ¶
type Conn ¶
type Conn struct {
// contains filtered or unexported fields
}
Conn remote: real server; local: relay
func (*Conn) ReadFrom ¶ added in v1.0.1
ReadFrom when client want to send to server, detect and split.
func (*Conn) RemoteAddr ¶ added in v1.0.1
RemoteAddr returns the remote network address.
func (*Conn) SetDeadline ¶ added in v1.0.1
SetDeadline sets the read and write deadlines associated with the connection.
func (*Conn) SetReadDeadline ¶ added in v1.0.1
SetReadDeadline sets the deadline for future Read calls.
func (*Conn) SetWriteDeadline ¶ added in v1.0.1
SetWriteDeadline sets the deadline for future Write calls.
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
Package main provides the main entry point for terasu.
|
Package main provides the main entry point for terasu. |
|
Package dns with DoT/DoH supports
|
Package dns with DoT/DoH supports |
|
Package http is a wrapper around the standard http library with enhanced DNS resolution and TLS handling capabilities.
|
Package http is a wrapper around the standard http library with enhanced DNS resolution and TLS handling capabilities. |
|
Package http2 is the same as the standard http lib with HTTP2 client support
|
Package http2 is the same as the standard http lib with HTTP2 client support |
|
Package http3 is the same as the standard http lib with HTTP3 client support
|
Package http3 is the same as the standard http lib with HTTP3 client support |
|
Package ip contains IP-related configs
|
Package ip contains IP-related configs |
Click to show internal directories.
Click to hide internal directories.