mirror of
				https://github.com/advplyr/audiobookshelf.git
				synced 2025-10-27 11:18:14 +01:00 
			
		
		
		
	Merge pull request #1814 from depwl9992/patch-1
Update readme.md - Expand required Apache modules for reverse proxy and detail how to handle acme challenges
This commit is contained in:
		
						commit
						8243da69f6
					
				
							
								
								
									
										28
									
								
								readme.md
									
									
									
									
									
								
							
							
						
						
									
										28
									
								
								readme.md
									
									
									
									
									
								
							@ -117,9 +117,11 @@ Add this to the site config file on your Apache server after you have changed th
 | 
				
			|||||||
 | 
					
 | 
				
			||||||
For this to work you must enable at least the following mods using `a2enmod`:
 | 
					For this to work you must enable at least the following mods using `a2enmod`:
 | 
				
			||||||
  - `ssl`
 | 
					  - `ssl`
 | 
				
			||||||
  - `proxy_module`
 | 
					  - `proxy`
 | 
				
			||||||
  - `proxy_wstunnel_module`
 | 
					  - `proxy_http`
 | 
				
			||||||
  - `rewrite_module`
 | 
					  - `proxy_balancer`
 | 
				
			||||||
 | 
					  - `proxy_wstunnel`
 | 
				
			||||||
 | 
					  - `rewrite`
 | 
				
			||||||
 | 
					
 | 
				
			||||||
```bash
 | 
					```bash
 | 
				
			||||||
<IfModule mod_ssl.c>
 | 
					<IfModule mod_ssl.c>
 | 
				
			||||||
@ -144,6 +146,26 @@ For this to work you must enable at least the following mods using `a2enmod`:
 | 
				
			|||||||
</IfModule>
 | 
					</IfModule>
 | 
				
			||||||
```
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					Some SSL certificates like those signed by Let's Encrypt require ACME validation. To allow Let's Encrypt to write and confirm 
 | 
				
			||||||
 | 
					the ACME challenge, edit your VirtualHost definition to prevent proxying traffic that queries `/.well-known` and instead
 | 
				
			||||||
 | 
					serve that directly:
 | 
				
			||||||
 | 
					```bash
 | 
				
			||||||
 | 
					<VirtualHost *:443>
 | 
				
			||||||
 | 
					    # ...
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					    # create the directory structure  /.well-known/acme-challenges
 | 
				
			||||||
 | 
					    # within DocumentRoot and give the HTTP user recursive write
 | 
				
			||||||
 | 
					    # access to it.
 | 
				
			||||||
 | 
					    DocumentRoot /path/to/local/directory
 | 
				
			||||||
 | 
					    
 | 
				
			||||||
 | 
					    ProxyPreserveHost On
 | 
				
			||||||
 | 
					    ProxyPass /.well-known !
 | 
				
			||||||
 | 
					    ProxyPass / http://localhost:<audiobookshelf_port>/
 | 
				
			||||||
 | 
					    
 | 
				
			||||||
 | 
					    # ...
 | 
				
			||||||
 | 
					</VirtualHost>    
 | 
				
			||||||
 | 
					```
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
					
 | 
				
			||||||
### SWAG Reverse Proxy
 | 
					### SWAG Reverse Proxy
 | 
				
			||||||
 | 
					
 | 
				
			||||||
 | 
				
			|||||||
		Loading…
	
		Reference in New Issue
	
	Block a user