mortenscheel/nginx-proxyman

CLI tool for nginx-proxy-manager

v1.1 2024-02-23 10:30 UTC

Requires

• php: ^8.2
• guzzlehttp/guzzle: ^7.4
• illuminate/http: ^9.0
• laravel-zero/framework: ^9.0

Requires (Dev)

• ergebnis/composer-normalize: ^2.42
• larastan/larastan: ^2.9
• laravel/pint: ^1.14
• mockery/mockery: ^1.4.4
• nunomaduro/termwind: ^1.3
• pestphp/pest: ^1.21.1
• phpro/grumphp: ^2.5
• yieldstudio/grumphp-laravel-pint: ^1.0

MIT

• Morten Scheel

• cli
• nginx-proxy

README

Proxyman is a simple cli tool for nginx-proxy-manager

I've written it for my own use cases, but feature requests and pull-requests are welcome.

Dependencies

• PHP >= 8.0
• mkcert (for generating self-signed certificates)

Installation

Composer

composer global require mortenscheel/nginx-proxyman

Manual

Download binary from latest release and place it in PATH

Usage

List proxy hosts

$ proxyman hosts:list
+--------------+----------------------+------+-----+---------+
| Domains      | Host                 | Port | SSL | Enabled |
+--------------+----------------------+------+-----+---------+
| mailhog.test | host.docker.internal | 8025 | ✓   | ✓       |
| proxy.test   | proxy                | 81   | ✓   | ✓       |
+--------------+----------------------+------+-----+---------+

Add proxy host

$ proxyman hosts:add [options] <domains>

	Description
domains	Space separated list of domain names (incl. wildcards)
--host	Name of host or docker-compose service (default: host.docker.internal)
--port	Default: 80
--https	Will create a self-signed certificate for the supplied domain names and force http requests to https

List self-signed certificates

$ proxyman cert:list
+------------------------+---------------------------------------------------+
| Name                   | Expires on                                        |
+------------------------+---------------------------------------------------+
| mailhog.test           | Saturday, May 25, 2024 6:26 PM (2 years from now) |
| proxy.test             | Saturday, May 25, 2024 6:25 PM (2 years from now) |
+------------------------+---------------------------------------------------+

Get self-signed certificate

$ proxyman cert:get <name> [--write]

Writes the key and crt to stdout, or writes them to files in the current directory