|
@@ -25,7 +25,7 @@ Twitter: [@neilpangxa](https://twitter.com/neilpangxa)
|
|
|
|
|
|
# [中文说明](https://github.com/Neilpang/acme.sh/wiki/%E8%AF%B4%E6%98%8E)
|
|
# [中文说明](https://github.com/Neilpang/acme.sh/wiki/%E8%AF%B4%E6%98%8E)
|
|
|
|
|
|
-# Who are using **acme.sh**
|
|
|
|
|
|
+# Who:
|
|
- [FreeBSD.org](https://blog.crashed.org/letsencrypt-in-freebsd-org/)
|
|
- [FreeBSD.org](https://blog.crashed.org/letsencrypt-in-freebsd-org/)
|
|
- [ruby-china.org](https://ruby-china.org/topics/31983)
|
|
- [ruby-china.org](https://ruby-china.org/topics/31983)
|
|
- [Proxmox](https://pve.proxmox.com/wiki/HTTPS_Certificate_Configuration_(Version_4.x_and_newer))
|
|
- [Proxmox](https://pve.proxmox.com/wiki/HTTPS_Certificate_Configuration_(Version_4.x_and_newer))
|
|
@@ -74,7 +74,7 @@ https://github.com/Neilpang/acmetest
|
|
- Webroot mode
|
|
- Webroot mode
|
|
- Standalone mode
|
|
- Standalone mode
|
|
- Apache mode
|
|
- Apache mode
|
|
-- Nginx mode ( Beta )
|
|
|
|
|
|
+- Nginx mode
|
|
- DNS mode
|
|
- DNS mode
|
|
- [Stateless mode](https://github.com/Neilpang/acme.sh/wiki/Stateless-Mode)
|
|
- [Stateless mode](https://github.com/Neilpang/acme.sh/wiki/Stateless-Mode)
|
|
|
|
|
|
@@ -204,6 +204,8 @@ Install/copy the cert/key to the production Apache or Nginx path.
|
|
The cert will be renewed every **60** days by default (which is configurable). Once the cert is renewed, the Apache/Nginx service will be reloaded automatically by the command: `service apache2 force-reload` or `service nginx force-reload`.
|
|
The cert will be renewed every **60** days by default (which is configurable). Once the cert is renewed, the Apache/Nginx service will be reloaded automatically by the command: `service apache2 force-reload` or `service nginx force-reload`.
|
|
|
|
|
|
|
|
|
|
|
|
+**Please take care: The reloadcmd is very important. The cert can be automatically renewed, but, without a correct 'reloadcmd' the cert may not be flushed to your server(like nginx or apache), then your website will not be able to show renewwed cert in 60 days.**
|
|
|
|
+
|
|
# 4. Use Standalone server to issue cert
|
|
# 4. Use Standalone server to issue cert
|
|
|
|
|
|
**(requires you to be root/sudoer or have permission to listen on port 80 (TCP))**
|
|
**(requires you to be root/sudoer or have permission to listen on port 80 (TCP))**
|
|
@@ -238,7 +240,7 @@ More examples: https://github.com/Neilpang/acme.sh/wiki/How-to-issue-a-cert
|
|
|
|
|
|
If you are running a web server, Apache or Nginx, it is recommended to use the `Webroot mode`.
|
|
If you are running a web server, Apache or Nginx, it is recommended to use the `Webroot mode`.
|
|
|
|
|
|
-Particularly, if you are running an Apache server, you should use Apache mode instead. This mode doesn't write any files to your web root folder.
|
|
|
|
|
|
+Particularly, if you are running an Apache server, you can use Apache mode instead. This mode doesn't write any files to your web root folder.
|
|
|
|
|
|
Just set string "apache" as the second argument and it will force use of apache plugin automatically.
|
|
Just set string "apache" as the second argument and it will force use of apache plugin automatically.
|
|
|
|
|
|
@@ -246,6 +248,10 @@ Just set string "apache" as the second argument and it will force use of apache
|
|
acme.sh --issue --apache -d example.com -d www.example.com -d cp.example.com
|
|
acme.sh --issue --apache -d example.com -d www.example.com -d cp.example.com
|
|
```
|
|
```
|
|
|
|
|
|
|
|
+**This apache mode is only to issue the cert, it will not change your apache config files.
|
|
|
|
+You will need to configure your website config files to use the cert by yourself.
|
|
|
|
+We don't want to mess your apache server, don't worry.**
|
|
|
|
+
|
|
More examples: https://github.com/Neilpang/acme.sh/wiki/How-to-issue-a-cert
|
|
More examples: https://github.com/Neilpang/acme.sh/wiki/How-to-issue-a-cert
|
|
|
|
|
|
# 7. Use Nginx mode
|
|
# 7. Use Nginx mode
|
|
@@ -266,6 +272,10 @@ So, the config is not changed.
|
|
acme.sh --issue --nginx -d example.com -d www.example.com -d cp.example.com
|
|
acme.sh --issue --nginx -d example.com -d www.example.com -d cp.example.com
|
|
```
|
|
```
|
|
|
|
|
|
|
|
+**This nginx mode is only to issue the cert, it will not change your nginx config files.
|
|
|
|
+You will need to configure your website config files to use the cert by yourself.
|
|
|
|
+We don't want to mess your nginx server, don't worry.**
|
|
|
|
+
|
|
More examples: https://github.com/Neilpang/acme.sh/wiki/How-to-issue-a-cert
|
|
More examples: https://github.com/Neilpang/acme.sh/wiki/How-to-issue-a-cert
|
|
|
|
|
|
# 8. Automatic DNS API integration
|
|
# 8. Automatic DNS API integration
|
|
@@ -332,7 +342,7 @@ For more details: [How to use DNS API](dnsapi)
|
|
|
|
|
|
# 9. Use DNS manual mode:
|
|
# 9. Use DNS manual mode:
|
|
|
|
|
|
-If your dns provider doesn't support any api access, you will have to add the txt record by your hand.
|
|
|
|
|
|
+If your dns provider doesn't support any api access, you can add the txt record by your hand.
|
|
|
|
|
|
```bash
|
|
```bash
|
|
acme.sh --issue --dns -d example.com -d www.example.com -d cp.example.com
|
|
acme.sh --issue --dns -d example.com -d www.example.com -d cp.example.com
|
|
@@ -370,7 +380,7 @@ Ok, it's done.
|
|
|
|
|
|
And we support them too!
|
|
And we support them too!
|
|
|
|
|
|
-Just set the `length` parameter with a prefix `ec-`.
|
|
|
|
|
|
+Just set the `keylength` parameter with a prefix `ec-`.
|
|
|
|
|
|
For example:
|
|
For example:
|
|
|
|
|
|
@@ -386,7 +396,7 @@ acme.sh --issue -w /home/wwwroot/example.com -d example.com --keylength ec-256
|
|
acme.sh --issue -w /home/wwwroot/example.com -d example.com -d www.example.com --keylength ec-256
|
|
acme.sh --issue -w /home/wwwroot/example.com -d example.com -d www.example.com --keylength ec-256
|
|
```
|
|
```
|
|
|
|
|
|
-Please look at the last parameter above.
|
|
|
|
|
|
+Please look at the `keylength` parameter above.
|
|
|
|
|
|
Valid values are:
|
|
Valid values are:
|
|
|
|
|