···

       
1
       
-
       
# `caddy_anubis`

     

       
2
       
 
       


     

       
3
       
 
       
You can add caddy-anubis to your server using xcaddy:

     

       
4
       
 
       


     

       
5
       
 
       
```

     

       
6
       
 
       
xcaddy build \

     

       
7
       
-
       
  --with github.com/kotx/caddy-anubis \

     

       
8
       
-
       
  --replace github.com/TecharoHQ/anubis=github.com/kotx/anubis-static@v1.21.0

     

       
9
       
 
       
  # ...any other plugins

     

       
10
       
 
       
```

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

       
0
       
 
       

     

···

       
1
       
+
       
# `caddy-anubis`

     

       
2
       
 
       


     

       
3
       
 
       
You can add caddy-anubis to your server using xcaddy:

     

       
4
       
 
       


     

       
5
       
 
       
```

     

       
6
       
 
       
xcaddy build \

     

       
7
       
+
       
  --with tangled.sh/kot.pink/caddy-anubis \

     

       
8
       
+
       
  --replace github.com/TecharoHQ/anubis=github.com/kotx/anubis-static@v1.23.1

     

       
9
       
 
       
  # ...any other plugins

     

       
10
       
 
       
```

     

       
11
       
+
       


     

       
12
       
+
       
## Example config

     

       
13
       
+
       


     

       
14
       
+
       
```Caddyfile

     

       
15
       
+
       
localhost {

     

       
16
       
+
       
	@anubis {

     

       
17
       
+
       
		# This matcher allows you to select specific paths for Anubis to handle.

     

       
18
       
+
       
		# If you want to handle all paths, remove this block and use `anubis {...}` instead!

     

       
19
       
+
       
		path / # don't let AI scrapers browse the file index

     

       
20
       
+
       
		path /.within.website/* # required for anubis to work

     

       
21
       
+
       


     

       
22
       
+
       
		not path /api/* # exclude api routes from anubis

     

       
23
       
+
       
	}

     

       
24
       
+
       


     

       
25
       
+
       
	log http.handlers.anubis {

     

       
26
       
+
       
		level DEBUG # optionally set log level

     

       
27
       
+
       
	}

     

       
28
       
+
       


     

       
29
       
+
       
	anubis @anubis {

     

       
30
       
+
       
		# This setting gets overridden a lot by the default bot policy.

     

       
31
       
+
       
		difficulty 4

     

       
32
       
+
       


     

       
33
       
+
       
		# Custom bot policy file

     

       
34
       
+
       
		policy_fname botPolicies.yaml

     

       
35
       
+
       


     

       
36
       
+
       
		private_key {$ED25519_PRIVATE_KEY} # for challenge persistence across restarts

     

       
37
       
+
       
										   # or if you're running multiple anubis instances

     

       
38
       
+
       
	}

     

       
39
       
+
       


     

       
40
       
+
       
	file_server browse

     

       
41
       
+
       
}

     

       
42
       
+
       
```

     

···

       
78
       
 
       
		return err

     

       
79
       
 
       
	}

     

       
80
       
 
       
	r.Header.Set("X-Real-Ip", remoteHost)

     

       
0
       
 
       

     

       
81
       
 
       


     

       
82
       
 
       
	m.next = next

     

       
83
       
 
       
	m.err = nil

     

···

       
78
       
 
       
		return err

     

       
79
       
 
       
	}

     

       
80
       
 
       
	r.Header.Set("X-Real-Ip", remoteHost)

     

       
81
       
+
       
	r.Header.Set("X-Http-Version", r.Proto)

     

       
82
       
 
       


     

       
83
       
 
       
	m.next = next

     

       
84
       
 
       
	m.err = nil

     

···

       
17
       
 
       
		difficulty 4

     

       
18
       
 
       


     

       
19
       
 
       
		# Custom bot policy.

     

       
20
       
-
       
		policy_fname example/botPolicy.yaml

     

       
21
       
 
       


     

       
22
       
 
       
		private_key "a183a07283e86b669e30e153ad4f0c7a9e2bbc3218fc8fa9d6b858b29e97d22b"

     

       
23
       
 
       


     

···

       
17
       
 
       
		difficulty 4

     

       
18
       
 
       


     

       
19
       
 
       
		# Custom bot policy.

     

       
20
       
+
       
		policy_fname botPolicy.yaml

     

       
21
       
 
       


     

       
22
       
 
       
		private_key "a183a07283e86b669e30e153ad4f0c7a9e2bbc3218fc8fa9d6b858b29e97d22b"

     

       
23
       
 
       


     

···

       
1
       
 
       
FROM caddy:builder AS builder

     

       
2
       
 
       


     

       
3
       
 
       
RUN xcaddy build \

     

       
4
       
-
       
    --with pkg.kot.pink/caddy-anubis

     

       
0
       
 
       

     

       
5
       
 
       


     

       
6
       
 
       
FROM caddy:latest

     

       
7
       
 
       


     

       
8
       
 
       
COPY --from=builder /usr/bin/caddy /usr/bin/caddy

     

       
9
       
 
       
COPY Caddyfile /etc/caddy/Caddyfile

     

       
10
       
-
       
COPY botPolicy.json .

     

···

       
1
       
 
       
FROM caddy:builder AS builder

     

       
2
       
 
       


     

       
3
       
 
       
RUN xcaddy build \

     

       
4
       
+
       
    --with tangled.sh/kot.pink/caddy-anubis \

     

       
5
       
+
       
    --replace github.com/TecharoHQ/anubis=github.com/kotx/anubis-static@v1.23.1

     

       
6
       
 
       


     

       
7
       
 
       
FROM caddy:latest

     

       
8
       
 
       


     

       
9
       
 
       
COPY --from=builder /usr/bin/caddy /usr/bin/caddy

     

       
10
       
 
       
COPY Caddyfile /etc/caddy/Caddyfile

     

       
11
       
+
       
COPY botPolicy.yaml .

     

···

       
1
       
-
       
module git.teto.zip/kot/caddy-anubis

     

       
2
       
 
       


     

       
3
       
 
       
go 1.25

     

       
4
       
 
       


     

···

       
1
       
+
       
module tangled.sh/kot.pink/caddy-anubis

     

       
2
       
 
       


     

       
3
       
 
       
go 1.25

     

       
4