go-i2ptunnel-config

Command line utility to convert I2P tunnel configurations between Java I2P, i2pd, and go-i2p formats.

Features

• Converts between .config (Java), .conf (i2pd), and .yaml formats
• Format auto-detection
• Validation checks
• Dry-run mode
• SAM (Simple Anonymous Messaging) integration with I2P key management
• No network connectivity required

Install

go install github.com/go-i2p/go-i2ptunnel-config@latest

Usage

Basic conversion with auto-detection:

go-i2ptunnel-config tunnel.config

Specify output format:

go-i2ptunnel-config --out-format ini tunnel.config

Specify custom output file:

go-i2ptunnel-config -o custom-name.yaml tunnel.config
go-i2ptunnel-config --output /path/to/output.conf tunnel.properties

Validate only:

go-i2ptunnel-config --validate tunnel.config

Test conversion (dry-run):

go-i2ptunnel-config --dry-run tunnel.config

Batch process multiple files:

go-i2ptunnel-config --batch "*.config"
go-i2ptunnel-config --batch --out-format ini "tunnels/*.properties"

Examples

The examples/ directory contains ready-to-use configuration templates for common tunnel types in all three formats:

• HTTP client (web proxy)
• HTTP server (eepsite hosting)
• SOCKS proxy
• Generic client tunnel
• Generic server tunnel

Each example includes detailed comments explaining the configuration options. See examples/README.md for more information.

Contributing

1. Fork repository
2. Create feature branch
3. Run make fmt
4. Submit pull request

Security

• No network connectivity
• No private key handling
• Configuration files only

License

MIT License