mirror of
https://github.com/caddyserver/xcaddy.git
synced 2024-09-16 17:30:16 +01:00
104 lines
2.2 KiB
Markdown
104 lines
2.2 KiB
Markdown
`xcaddy` - Custom Caddy Builder
|
|
===============================
|
|
|
|
This command line tool and associated Go package makes it easy to make custom builds of the [Caddy Web Server](https://github.com/caddyserver/caddy).
|
|
|
|
It is used heavily by Caddy plugin developers as well as anyone who wishes to make custom `caddy` binaries (with or without plugins).
|
|
|
|
Supports Caddy 2 and up.
|
|
|
|
⚠️ Still in development.
|
|
|
|
Stay updated, be aware of changes, and please submit feedback! Thanks!
|
|
|
|
## Requirements
|
|
|
|
- Go installed
|
|
- Go modules enabled
|
|
|
|
|
|
## Command usage
|
|
|
|
The `xcaddy` command has two primary uses:
|
|
|
|
- Compile custom `caddy` binaries
|
|
- A replacement for `go run` while developing Caddy plugins
|
|
|
|
Install the `xcaddy` command with:
|
|
|
|
```bash
|
|
$ go get -u github.com/caddyserver/xcaddy/cmd/xcaddy
|
|
```
|
|
|
|
|
|
### Custom builds
|
|
|
|
Syntax:
|
|
|
|
```
|
|
$ xcaddy build <caddy_version>
|
|
[--output <file>]
|
|
[--with <module[@version]>...]
|
|
```
|
|
|
|
- `<caddy_version>` is the core Caddy version to build (required, for now).
|
|
- `--output` changes the output file.
|
|
- `--with` can be used multiple times to add plugins by specifying the Go module name and optionally its version, similar to `go get`.
|
|
|
|
For example:
|
|
|
|
```bash
|
|
$ xcaddy build v2.0.0-rc.1 \
|
|
--with github.com/caddyserver/ntlm-transport@v0.1.0
|
|
```
|
|
|
|
### For plugin development
|
|
|
|
If you run `xcaddy` from within the folder of the Caddy plugin you're working on without the `build` subcommand described above, it will build Caddy with your current module and run it, as if you manually plugged it in and ran `go run`.
|
|
|
|
The binary will be built and run from the current directory, then cleaned up.
|
|
|
|
The current working directory must be inside an initialized Go module.
|
|
|
|
Syntax:
|
|
|
|
```
|
|
$ xcaddy <args...>
|
|
```
|
|
- `<args...>` are passed through to the `caddy` command.
|
|
|
|
For example:
|
|
|
|
```bash
|
|
$ xcaddy list-modules
|
|
$ xcaddy run
|
|
$ xcaddy run --config caddy.json
|
|
```
|
|
|
|
|
|
|
|
|
|
## Library usage
|
|
|
|
```go
|
|
builder := xcaddy.Builder{
|
|
CaddyVersion: "v2.0.0-rc.1",
|
|
Plugins: []xcaddy.Dependency{
|
|
{
|
|
ModulePath: "github.com/caddyserver/ntlm-transport",
|
|
Version: "v0.1.0",
|
|
},
|
|
},
|
|
}
|
|
err := builder.Build("./caddy")
|
|
```
|
|
|
|
Versions can be anything compatible with `go get`.
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
© 2020 Matthew Holt
|