Find a file
2023-04-04 11:08:29 +08:00
demo initial commit 2023-03-09 17:55:45 +08:00
doc add user guide 2023-04-04 11:05:51 +08:00
g3bench g3rcgen: add vendored-openssl feature and update pkg files 2023-04-04 11:02:37 +08:00
g3fcgen g3fcgen: init openssl 2023-04-04 11:07:45 +08:00
g3proxy g3proxy: use a single cli options for dep graph 2023-04-04 11:08:29 +08:00
g3tiles g3rcgen: add vendored-openssl feature and update pkg files 2023-04-04 11:02:37 +08:00
lib g3proxy: add mermaid graph option 2023-04-04 11:06:45 +08:00
scripts rename g3rcgen to g3fcgen 2023-04-04 11:03:05 +08:00
.gitignore initial commit 2023-03-09 17:55:45 +08:00
Cargo.lock g3proxy: use a single cli options for dep graph 2023-04-04 11:08:29 +08:00
Cargo.toml rename g3rcgen to g3fcgen 2023-04-04 11:03:05 +08:00
CHANGELOG.md add user guide 2023-04-04 11:05:51 +08:00
CODE_OF_CONDUCT.md initial commit 2023-03-09 17:55:45 +08:00
CONTRIBUTING.md initial commit 2023-03-09 17:55:45 +08:00
LICENSE initial commit 2023-03-09 17:55:45 +08:00
README.md rename g3rcgen to g3fcgen 2023-04-04 11:03:05 +08:00

minimum rustc: 1.66 License: Apache 2.0

G3 Project

About

This is the project we used to build enterprise-oriented general proxy solutions, including but not limited to proxy / reverse proxy / load balancer / nat traversal.

Components

G3 Project is make up of many components.

The project level docs resides in the doc subdirectory, and you should see the links below for the important ones. Each component will have its own doc in its doc subdirectory.

g3proxy

A general forward proxy solution, but you can also use it as tcp streaming / transparent proxy / reverse proxy as we have basic support built in.

See g3proxy for detailed introduction.

g3tiles

A work in progress reverse proxy solution.

g3bench

A benchmark tool for the test of g3proxy.

g3fcgen

Fake certificate generator for g3proxy.

Dev-env Setup Guide

Follow dev-setup.

Standards

Follow standards.

Release and Packaging

We will set tags for each release of each component, in the form <name>-v<version>. You can use these tags to generate source tarballs. And we have added deb and rpm package files for each component that is ready for distribution.

If you want to do a release build:

  1. generate a release tarball

    ./scripts/release/build_tarball.sh <name>-v<version>
    

    All vendor sources will be added to the source tarball, so you can save the source tarball and build it offline at anywhere that have the compiler and dependencies installed.

  2. build the package

    For deb package:

    tar xf <name>-<version>.tar.xz
    cd <name>-<version>
    ./build_deb_from_tar.sh
    

    For rpm package:

    tar xvf <name>-<version>.tar.xz ./<name>-<version>/<name>.spec
    cp <name>-<version>.tar.xz ~/rpmbuild/SOURCES/
    rpmbuild -ba ./<name>-<version>/<name>.spec
    

If you want to build a package directly from the git repo:

  • For deb package:

    ./build_deb_from_git.sh <name>
    
  • For rpm package:

    ./build_rpm_from_git.sh <name>
    

Contribution

Please check Contributing for more details.

Code of Conduct

Please check Code of Conduct for more details.

Security

If you discover a potential security issue in this project, or think you may have discovered a security issue, we ask that you notify Bytedance Security via our security center or vulnerability reporting email.

Please do not create a public GitHub issue.

License

This project is licensed under the Apache-2.0 License.