Update README.md

This commit is contained in:
El 2024-03-18 20:32:42 +08:00 committed by GitHub
parent 5f6e04c3a9
commit ab22fc9f15
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 51 additions and 7 deletions

View File

@ -1,4 +1,22 @@
# bird-looking-glass-proxy # bird-looking-glass-proxy
[![Contributors][contributors-shield]][contributors-url]
[![Forks][forks-shield]][forks-url]
[![Stargazers][stars-shield]][stars-url]
[![Issues][issues-shield]][issues-url]
[![MIT License][license-shield]][license-url]
Bird Looking Glass Proxy is a svelte web API contrived to administer BIRD and Traceroute instances, furnishing a streamlined interface for network diagnostics and management.
[contributors-shield]: https://img.shields.io/github/contributors/undef-i/bird-looking-glass-proxy.svg?style=flat-square
[contributors-url]: https://github.com/undef-i/bird-looking-glass-proxy/graphs/contributors
[forks-shield]: https://img.shields.io/github/forks/undef-i/bird-looking-glass-proxy.svg?style=flat-square
[forks-url]: https://github.com/undef-i/bird-looking-glass-proxy/network/members
[stars-shield]: https://img.shields.io/github/stars/undef-i/bird-looking-glass-proxy.svg?style=flat-square
[stars-url]: https://github.com/undef-i/bird-looking-glass-proxy/stargazers
[issues-shield]: https://img.shields.io/github/issues/undef-i/bird-looking-glass-proxy.svg?style=flat-square
[issues-url]: https://github.com/undef-i/bird-looking-glass-proxy/issues
[license-shield]: https://img.shields.io/github/license/undef-i/bird-looking-glass-proxy.svg?style=flat-square
[license-url]: https://github.com/undef-i/bird-looking-glass-proxy/blob/master/LICENSE.txt
``` ```
USAGE: USAGE:
bird-looking-glass-proxy [OPTIONS] bird-looking-glass-proxy [OPTIONS]
@ -8,14 +26,40 @@ OPTIONS:
-e, --example Export sample config file -e, --example Export sample config file
-h, --help Print help information -h, --help Print help information
``` ```
## Quick Start ## Commencing
> Make sure that `bird` and `traceroute` are installed and available. To commence with Bird Looking Glass Proxy, follow the steps expounded below:
1. Obtain the binary executable by either downloading it from the release or compiling the project with `cargo`. ### Requisites
2. Use the command `bird-looking-glass-proxy --example > config.toml` to create a template configuration file and modify it to your needs. Before you embark, ensure you have the subsequent requisites:
3. Run the executable. * **BIRD**: Ensure that BIRD (BGP Internet Routing Daemon) is installed and configured properly. Bird Looking Glass Proxy relies on BIRD for routing information.
* **Traceroute**: Make sure that the traceroute utility is installed and available in your system. It is utilized for network diagnostics and troubleshooting, which is imperative for the functionality of Bird Looking Glass Proxy.
* **Rust**: If you intend to compile the project from source, ensure you have Rust installed. You can install Rust by following the instructions on rustup.rs.
### Installation
You can procure the binary executable for Bird Looking Glass Proxy from the [releases page](https://github.com/undef-i/bird-looking-glass-proxy/releases). Alternatively, you have the option to compile the project on your own.
1. Make sure that `bird` and `traceroute` are installed and available.
2. Obtain the binary executable by either downloading it from the release or compiling the project with `cargo`. The compiled binary will be available in the target/release directory.
3. Use the command `bird-looking-glass-proxy --example > config.toml` to create a template configuration file and modify it to your needs.
4. Run the executable.
### Tips ### Tips
The default configuration file is located at `./config.toml`, but you can customize the file location using the `-c` or `--config` parameter. * The default configuration file is located at `./config.toml`, but you can customize the file location using the `-c` or `--config` parameter.
## Known issues
* Versions built with the `*-unknown-linux-gnu` toolchain may not function correctly on systems with `GLIBC` versions below `2.35`. To resolve this, use a statically linked version built with the `*-unknown-linux-musl` toolchain. * Versions built with the `*-unknown-linux-gnu` toolchain may not function correctly on systems with `GLIBC` versions below `2.35`. To resolve this, use a statically linked version built with the `*-unknown-linux-musl` toolchain.
## Perspective
Our future aspirations for Bird Looking Glass Proxy encompass:
* Enhancing compatibility with different system architectures.
* Augmenting logging and error handling mechanisms.
* Implementing additional features for enhanced customization.
## Collaborative Endeavors
Contributions are cordially invited! Feel unshackled to open issues or submit pull requests to aid in ameliorating Bird Looking Glass Proxy.
## License
Bird Looking Glass Proxy is licensed under the GNU General Public License v3.0 (GPLv3). Peruse the LICENSE file for details.
## Contact
For inquiries or support, please reach out to i@nedifinita.com.