前言
如果有人问我:你觉得最重要的docker应用有些?
我的答案是:
ddns-go
。非常好用的动态域名解析服务。家用NAS必备神器。NPM
。Nginx反向代理神器之一,自动管理nginx代理配置、Let's Encrypt的ssl证书自动申请和续期。
当然,这里我不会说mysql/mariadb
,因为它们往往不直接面对用户,我们很难感受到它们的存在,虽然它们在搭建docker应用的时候会经常出现。
本文主要解决如何安装和基本使用
NPM/ddns-go。我之所以将两者合并讨论,是因为它们的组合可以很好地解决如何方便和安全地远程访问docker应用
这个使用场景。
值得一说的是,如果你用的是VPS,有固定的公网ip,此时ddns-go
不是必需的。你只需要去阿里云、cloudflare这样的域名托管商的后台一次性添加就行了!
当然,有些小伙伴可能都没怎么听说过这两个应用。除了之前测试用的Ward
,这两个应用就是我们安装好Docker要首先安装的应用噢!
下面我们一起来看看吧 :satisfied:
测试环境
- 操作系统: Linux openmediavault 5.4.174-2-pve #1 SMP PVE 5.4.174-2 (Thu, 10 Mar 2022 15:58:44 +0100) x86_64 GNU/Linux
- Docker: Docker version 20.10.14, build a224086
- docker-compose: Docker Compose version v2.4.1
准备工作
# 工作目录请按需修改喔
# path_docker=/nas
path_docker=~/docker
# 目录管理
sudo mkdir -p ${path_docker}/ddns-go/ ${path_docker}/npm
sudo chown -R user:group ${path_docker}/ddns-go/ ${path_docker}/npm # 你的用户(组)
# 提前拉取好镜像
docker pull jeessy/ddns-go:latest
docker pull jc21/nginx-proxy-manager:latest
另外,你还需要在阿里云或者cloudflare进行域名托管,并且有至少1个域名。其它域名服务商应该也是类似的,我用是就是这两个,其它的不特别讨论。
DDNS-GO目前支持的DNS服务商有:Alidns(阿里云)、Dnspod(腾讯云)、Cloudflare、华为云和Callback。
NPM支持的服务商太多了,自己去看看吧,不再赘述。
NPM
Nginx proxy manager(NPM)是集Nginx设置和ssl证书申请的docker神器。
目录管理
cd ${path_docker}/npm
配置yml文件
创建新文件docker-compose.yml
并添加内容如下:
version: '3'
services:
app:
image: 'jc21/nginx-proxy-manager:latest'
restart: unless-stopped
ports:
- '80:80'
- '<NPM-后台端口>:81'
- '443:443'
volumes:
- ./data:/data
- ./letsencrypt:/etc/letsencrypt
你可以使用默认端口或者自定义。
一般地,对于VPS来说,80和443端口应该使用默认的。可以使用80和443端口也是玩VPS的优势之一呀!想想你每次访问互联网服务都要加个端口号,看着就很难受。你的家用NAS一般是你或者你的家人等少数人用,有一些端口号也无伤大雅。
可是,如果你要建一个个人博客,用非443端口不合适吧?看着就很不正式呢!
一般地,新买的个人云服务器可以默认;而家用宽带一般不放行443端口,而要改用其它端口。
另外,这个81端口是NPM的默认后台端口,这个你可以改一个自己喜欢的。我建议不要用默认的81端口,这样可以使NPM更加隐蔽。
服务管理
# 上线服务
docker-compose up -d
# 下线服务
docker-compose down
# 更新服务(我还没用过。更新的话建议先对旧服务进行备份,以防新旧版本有兼容问题。)
docker-compose pull
docker-compose up -d
不要忘了用ufw
开放你选择的NPM-后台端口
端口喔!还记得ufw
怎么用吗?443
、80
端口在之前的演示中应该已经开放过了。自己用sudo ufw status numbered
查询一下。
访问:http://<ip>:<NPM-后台端口>
进行NPM管理。
根据官网,它的默认帐户和密码是:
默认帐户:[email protected]
默认密码:changeme
进入后台后,具体使用可以参考B站的咕咕鸽的演示:https://www.bilibili.com/video/BV1Gg411w7kQ。这里我也简单地介绍一下NPM的使用方式。
特别注意
:
个人宽带的公网ip不开放80端口,所以在NPM中一般用DNS challege而不是HTTP challege的方式申请Let's Encrypt SSL证书。如果你使用的是DNS challege的方式,一般还要提供一些token信息,这个每个托管商都是不太一样的。你可以试一下,HTTP challege失败就换DNS challege。我在国内都可以成功申请到证书。
如果你用VPS的话,应该没有这个问题。这也是为什么推荐新手玩VPS嘛 :stuck_out_tongue_winking_eye:
这里值得一说的是,NPM是可以反向代理自己的!你第一次访问NPM的时候,是用http://<ip>:<NPM-后台端口>
的方式访问,这个时候你输入的帐户和密码都是明文传播的。你设置好NPM的自身反代后,要尽快用https://domain.com
的方式来访问它,然后将用户名和密码修改一下。NPM是本地和外界沟通的桥梁,可不能有什么安全隐患!
使用方法
申请SSL证书
我喜欢统一申请好二级域名证书(比如我自己,就只为hwb0307.com
申请1个证书),然后在建立新的反向代理记录后添加申请好的二级域名证书。
在国内,由于家庭宽带的80端口是被封锁的,所以用http challenge申请ssl证书的方式很容易失败。在Nginx proxmy manager中,国内用户推荐使用DNS challge的方式来申请Let's Encrypt证书。这里也主要是讲述后者的方式。帐户设置等初始化工作就不再赘述。自己摸索一下,不是很难。
如果你想了解HTTPS证书相关的原理跟细节,可以阅读Ryan的博客文章《写给开发人员的实用密码学(八)—— 数字证书与 TLS 协议》。
在界面中点击SSL Certificates--Add SSL Certificate--Let's Encrypt
其它设置如下图。你可以申请一个二级域名的通用证书,或者专门为一个三级域名设置证书。下面我展示的是申请一个二级域名的通用证书。我个人推荐你申请一个二级域名证书给所有的三级域名使用。你要同时为两个域名申请*.hwb0307.com
、hwb0307.com
(*
是一种常用的正则表达式,用来代表所有字符),这样才可以正常使用喔:
个人的key和secret要注意保密。DNA provider可以选好多种,看你自己的情况。
对于腾讯云(DNSPod)的用户,ID和Token一定要填一起才可以使用喔!比如,你的后台Token信息如下:
填写时应该是:
dns_dnspod_email = "自己的邮箱"
dns_dnspod_api_token = "31XXXX,7ccXXXXXXXXXXXXXXXXXXXXX7"
按要求填写好相关信息后,按save
保存并申请SSL证书,稍等一会即可。如果有报错的话,再多试几次,检查一下自己的信息有没有填写错误。我在国内外的网络环境中通过DNS challenge的方法都可以成功申请证书。成功后如下图所示:
添加反向代理记录
添加一个记录:
这里以ddns-go为例。比如,ddns-go的反向代理设置如下。这个172.17.0.1
是docker的默认主机ip地址,通过这个地址加上docker应用的ports即可访问具体的docker应用。当然用192.XXX之类的地址也是可以的,你都可以试试看。
值得一提的是,这里NPM和ddns-go都是在同一个局域网中,所以可以通过反代局域网地址加端口号成功实现。而且,你不需要在路由器中为ddns-go专门设置一个端口映射,这样在互联网使用的环境下,外部的应用只能通过NPM对ddns-go服务进行访问。由于这种访问是https加密的,因此具有较好的安全性。
点击save保存,就会有一条记录:
此时通过:https://exampledomain.com:<NPM-443端口>
即可访问ddns-go。如果你用的是443端口,可以不加端口号,因为443是互联网中默认的https端口。
多数docker应用可以通过这样简单地设置即可以实现成功代理。不过,不是所有的docker服务都这么简单就可以设置好反代,它们还往往需要一些额外的Nginx基础才可以成功,比如Umami
。具体情况具体分析。有机会再开一个专题来讨论NPM的nginx自定义配置吧。
自动更新证书
NPM托管的Let's Encrytp证书是可以自动更新的,访过程基于certbot。在conf文件里,有一个renew_before_expiry
的参数,默认是30 days
。Let's Encrytp证书的有效期一般是3个月,它会在证书还有1个月到期的时候自动更新证书。
我有一个关于*.hwb0307.com, hwb0307.com
域名的证书,通过DNS challege的方法申请的。该证书由Cloudflare颁发,有效期是1年而不是3个月:
当该证书没到仅剩30天过期时,尽管手动renew,证书依然不会被更新(日志信息提示Certificate not yet due for renewal
):
npm-app-1 | [10/24/2022] [10:19:32 AM] [SSL ] › ℹ info Renewing Let'sEncrypt certificates via Cloudflare for Cert #20: *.hwb0307.com, hwb0307.com
npm-app-1 | [10/24/2022] [10:19:32 AM] [SSL ] › ℹ info Command: certbot renew --config "/etc/letsencrypt.ini" --cert-name "npm-20" --disable-hook-validation --no-random-sleep-on-renew
npm-app-1 | [10/24/2022] [10:19:34 AM] [SSL ] › ℹ info - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
npm-app-1 | Processing /etc/letsencrypt/renewal/npm-20.conf
npm-app-1 | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
npm-app-1 | Certificate not yet due for renewal
npm-app-1 |
npm-app-1 | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
npm-app-1 | The following certificates are not due for renewal yet:
npm-app-1 | /etc/letsencrypt/live/npm-20/fullchain.pem expires on 2022-11-24 (skipped)
npm-app-1 | No renewals were attempted.
npm-app-1 | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
我另外一个非DNS challege申请的证书,应该是Let's Encrypt直接颁发的证书。它可以随时更新:
npm-app-1 | [10/24/2022] [10:27:28 AM] [SSL ] › ℹ info Renewing Let'sEncrypt certificates for Cert #22: XXX.org
npm-app-1 | [10/24/2022] [10:27:28 AM] [SSL ] › ℹ info Command: certbot renew --force-renewal --config "/etc/letsencrypt.ini" --cert-name "npm-22" --preferred-challenges "dns,http" --no-random-sleep-on-renew --disable-hook-validation
npm-app-1 | [10/24/2022] [10:27:37 AM] [SSL ] › ℹ info - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
npm-app-1 | Processing /etc/letsencrypt/renewal/npm-22.conf
npm-app-1 | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
npm-app-1 | Renewing an existing certificate for XXX.org
npm-app-1 |
npm-app-1 | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
npm-app-1 | Congratulations, all renewals succeeded:
npm-app-1 | /etc/letsencrypt/live/npm-22/fullchain.pem (success)
npm-app-1 | - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -
不过,不管哪种方式,如果证书快到期了,应该是可以自动续期的。这里建议:如果你想频繁地更换证书,不要使用DNS challenge的方式申请。
ddns-go
ddns-go
是一个动态域名解析神器,并提供漂亮的UI界面进行操作。简单好用的DDNS。支持阿里云DNS、腾讯云dnspod、Cloudflare、华为云 。官方镜像:https://registry.hub.docker.com/r/jeessy/ddns-go
温馨提示:使用VPS的小伙伴可以不安装这个ddns-go。每次有新的域名要解析,去域名托管商的后台进行操作即可。
在ddns-go
里,我们会展示一些Docker中相对特殊的用法:
- PUID和PGID可通过在Shell中输入
id
进行查询。这个在Linux基础里已经学过了!当然你也可以用root来运行,我也觉得没什么问题。值得注意的是,不是所有的docker应用都有这两个参数。可能Dockerfile
之类的方法可以指定,但我还没有尝试过。基于Docker系列 学习Docker之前中的讨论,你应该也知道一般情况下用root运行docker问题也不大的。 - 我们用
Shell命令行
来安装ddns-go。其实Shell命令行
是我最先接触的方法,对于一些比较简单的Docker应用,用它来安装也是毫无压力的。用docker-compose
的方案也行,有兴趣的自己试试看吧!
我展示一下阿里云和cloudflare的使用。应该还是蛮简单的吧 😉
阿里云
# aliyun
mkdir -p ${path_docker}/ddns-go/aliyun
docker run -d \
--restart=unless-stopped \
--name ddns-go-aliyun \
-e PUID=1000 \
-e PGID=100 \
-p <aliyun端口>:9876 \
-v ${path_docker}/ddns-go/aliyun:/root \
jeessy/ddns-go \
-f 60
访问http://<ip>:<aliyun端口>/
进行aliyun的域名解析。
Cloudflare
# cloudflare
mkdir -p ${path_docker}/ddns-go/cloudflare
docker run -d \
-e PUID=1000 \
-e PGID=100 \
--name ddns-go-cloudflare \
--restart=unless-stopped \
-p <cloudflare端口>:9876 \
-v ${path_docker}/ddns-go/cloudflare:/root \
jeessy/ddns-go \
-f 60
访问http://<ip>:<cloudflare端口>/
进行aliyun的域名解析。
ddns-go使用
NPM设置Nginx反代和ssl加密
在进行设置的时候,应该先用NPM进行反向代理和配置https加密。不然,你的所有信息都是明文传播,容易引发安全问题。强烈不推荐在http协议中使用ddns-go,因为它会传送你的DNS服务商的token,这意味着攻击者可以对你的帐号进行任何操作!
设置可以看上文的NPM的举例。
绑定DNS服务商
阿里云的是这样的:
Cloudflare的是这样的:
IPv4设置
用默认的参数,然后在Domains里写上要解析的域名。注意,你不需要专门去域名服务商后台添加记录。
其它配置
我喜欢设置用户名和密码,这样公网访问的时候会比较安全。
设置完成后,就点击页面左上方的Save
。这里会自动解析域名。右侧可以看到日志,会有IPv4未改变,将等待 5 次后与DNS服务商进行比对
、你的IP XXX 没有变化, 域名XXX
或者XXX解析成功
之类的字样。
参考资料
- https://nginxproxymanager.com/advanced-config/#docker-secrets
- 申请通配符SSL证书,让批量添加网站更省力!
- B站大佬的教学视频:https://www.bilibili.com/video/BV1Gg411w7kQ
- 域名从NameSilo转移到Cloudflare
---------------
完结,撒花!如果您点一下广告,可以养活苯苯😍😍😍
你好,我也是家里安装DOCKER安装的NPM和DDNS-GO,设置也跟你一样,可是反代不成功,这需要端口映射吗?因为我在内网IP+端口是可以访问的
有几种情况你需要核实:(1)家里的宽带是否已经申请公网ip。(2)是否使用了80/443端口;这两个端口在目前的家庭宽带里是不可用的,所以当你使用http/https协议访问docker服务时,要换成其它端口;具体在Nginx Proxy Manager的docker-compose.yml文件里改动80/443映射的端口。(3)是否使用防火墙以及端口号是否被开放了。(4)外网访问时还需要在路由器上做好端口映射。
感谢回复!我也在老苏那边提了问,他回复提醒我的一个点,我知道我错在那了,就是NPM容器映射到主机的端口搞错了,我应该将那个端口再映射出去,原先我是直接将ARMBIAN上的443直接映射出去,所以不行,因为NPM映射到主机的端口不是这个!现在成功了!
感觉这里电信还是有那么一点良心吧,可以申请公网IP,443居然没封。听朋友说用两天会就会封,不知道真假,
从2022年11月起,443端口就不再可用了。家用场景不建议你使用443,反正有很多其它端口可以使用嘛!
端口映射逻辑如下: 容器端口——宿主机端口——反向代理为某443类端口(比如端口A)——路由器端口映射(端口B→端口A)。然后,访问
https://URL:端口B
。我现在的443还可以。按你的意思用其他端口?https://URL:端口这样也行吗?我以为只可以443
443你能用的话也可以用。 其实我们平时访问的
https://url
, 本质上是https://url:443
。只是,由于443是默认的https端口,所以浏览器会自动隐藏这个端口号。 如果你使用的不是默认的443端口号, 那么这个端口将不会自动隐藏。 本质上是一样的,只是看上去有点不同。感谢回复,我大概了解了!
贴下自己的vps(国外)+域名+本篇npm设置。
namesil
(这里买的域名): 删除dns record里默认的,nameserver里替换成cloudflare的。对应的cloudflare
:添加上一些dns record,比如www, @ 和 cc。ddnsgo
未使用npm
端口设置自定义,举个栗子188
。使用ip:188登录到后台。使用的是http challenge, 假设域名为
good.com
,具体如下:dns chanllenge
,多尝试几次,有时出错Proxy host
里设置反向代理:设置给npm用的domain name
,比如aa.good.com
查看图片
Proxy host
,编辑-SSL-打开Force SSL
和HTTP/2
5.在cloudflare里补充aa的dns record
这下就可以用https://aa.good.com来直接进入npm后台了。之后如果有新的应用端口添加,那么就重复2-5步。
虽然能运行ψ(`∇´)ψ,但不知道自己的理解对不对╮(╯▽╰)╭
所谓DNS challenge,是80端口不可用或者说80端口可用但要申请根域名证书(比如
hwb0307.com, *.hwb0307,com
)时才推荐使用。否则,一般http申请Let’s Encrypt证书即可(这种方式申请的证书NPM会自动续期)。具体到某个子域名,比如blog.hwb0307.com
,我们简单申请一个Let’s Encrypt证书。至于设置一个反向Proxy,步骤就是你说的那样,大同小异 ヾ(≧∇≦*)ゝ(☆ω☆)原来如此!谢谢解答~
大佬你好,申请 SSL 证书的 aliyun_access_key 在哪里找啊?
如图所示:
![image-20221109105206446]()
查看图片
。
你也可以百度一下,教程应该也蛮多的。
想问下,搭建完NPM后,查看运行状态,提示“Unit nginx.service could not be found.”怎么回事啊??系统是Ubuntu 20.04 LTSC的,装了几遍都是这个结果,NPM面板无法登录,防火墙关闭的,dockers container也运行
和Ubuntu 20的系统没有关系,大概率是其它问题。从目前的状态来看还无法进行bug定位。如果可以的话,可以远程帮你看看。可以加Telegram群进一步了解。
感谢大佬的系列教程,现在遇到了好几个本地NAS的docker服务无法反代,比如
操作我感觉应该没问题,
nas
,软路由
,jellyfin
,npm
都可以,不知道为啥上面的就不行,大佬有空能一起探讨下吗。我是用的
cloudflare
,然后ddns
家宽的bitwarden和ddns-go我都可以成功,没啥特别的呀 qb我没试过 但我的transmission也没问题啊
可以加telegram群交流:https://t.me/benszhub
我的家宽用阿里ddns,反代总是不成功,能帮忙看看吗?
我用的就是aliyun,是可以成功的。你可以加一下群,大家看看你的情况:https://t.me/benszhub
啊~~我这个小白。请教一波,
要> 添加反向代理记录
那一步之前,我是不是要把自己服务器所在的网络固定静态公网ip?而且在域名托管的平台设置好域名解析?
您这条评论之前被标记为了垃圾邮件(我也不知道为啥(๑•̀ㅁ•́ฅ) ),不好意思哈!
VPS的公网ip是固定的,你可以不需要使用DDNS-go。那是给家用服务器设计的。
大致的步骤是:域名管理后台将域名——公网ip的关系确定好即(通常是添加一条A记录)
npm牛啊,一开始我还以为是JavaScript那个npm。操作的时候出现一个问题。如果使用Cloudflare做DNS,我陷入了一个
ERR_TOO_MANY_REDIRECTS
的error。查了之后发现可能是Cloudflare的问题,这里是解决方法。