luccioman/yacy

YaCy 最新源码构建 Docker 镜像

支持的标签及对应 Dockerfile

• latest（基于Debian的Dockerfile）
• latest-alpine（基于Alpine Linux的Dockerfile.alpine）

从Docker Hub获取镜像

bash
docker pull luccioman/yacy

仓库地址：https://hub.docker.com/r/luccioman/yacy/

自行构建镜像

使用yacy_search_server/docker/Dockerfile构建：

bash
cd yacy_search_server/docker
docker build .

构建Alpine变体：

bash
cd yacy_search_server/docker
docker build -f Dockerfile.alpine .

镜像变体说明

• luccioman/yacy:latest：基于Debian稳定版OpenJDK 8镜像，嵌入从最新Git仓库源码编译的YaCy。
• luccioman/yacy:latest-alpine：基于Alpine Linux稳定版OpenJDK 8镜像，嵌入从最新Git仓库源码编译的YaCy。

默认管理员账户

• 登录名：admin
• 密码：docker
  注意：若公开暴露容器，需通过页面/ConfigAccounts_p.html修改默认密码。

使用指南

首次启动

最基础启动

bash
docker run luccioman/yacy

YaCy web界面暴露在http://[容器IP]:8090，可通过docker inspect获取容器IP。

更易管理的启动

bash
docker run --name yacy -p 8090:8090 -p 8443:8443 --log-opt max-size=200m --log-opt max-file=2 luccioman/yacy

选项说明：

• --name：指定容器名称，方便管理（默认Docker会自动生成名称）。
• -p 8090:8090 -p 8443:8443：映射主机端口到容器端口，可通过http://localhost:8090和https://localhost:8443访问（可自定义映射，如-p443:8443使用主机默认HTTPS端口）。
• --log-opt max-size：限制容器日志文件最大大小。
• --log-opt max-file：限制日志文件轮换数量。
  提示：若不设置日志选项，24小时运行的YaCy容器日志会在几天内增长到数GB。

持久化数据卷

默认情况下，YaCy数据（/opt/yacy_search_server/DATA）会保存在自动生成ID的卷中。可映射主机目录或使用命名卷：

• 映射主机目录：

  bash
  docker run -v [你的主机数据目录]:/opt/yacy_search_server/DATA luccioman/yacy
  

• 使用命名卷：

  bash
  docker run -v yacy_volume:/opt/yacy_search_server/DATA luccioman/yacy
  

查看所有Docker卷：docker volume ls

后台启动

bash
docker run -d luccioman/yacy

HTTPS支持

镜像默认启用HTTPS，使用defaults/freeworldKeystore中的默认证书。建议替换为自有证书：

自签名证书

自签名证书可加密通信，但浏览器会提示“SEC_ERROR_UNKNOWN_ISSUER”。生成并添加：

bash
keytool -keystore /var/lib/docker/volumes/[你的YaCy卷]/_data/SETTINGS/yacykeystore -genkey -keyalg RSA -alias yacycert

编辑YaCy配置文件（如用nano）：

bash
nano /var/lib/docker/volumes/[你的YaCy卷]/_data/SETTINGS/yacy.conf

配置keyStore相关属性：

keyStore=/opt/yacy_search_server/DATA/SETTINGS/yacykeystore
keyStorePassword=你的密码

导入已有证书

导入CA验证的证书可避免浏览器错误。导入PKCS12格式证书：

1. 复制证书到卷：

   bash
   cp [你的证书].pkcs12 /var/lib/docker/volumes/[你的YaCy卷]/_data/SETTINGS/[你的证书].pkcs12
   

2. 编辑配置文件：

   bash
   nano /var/lib/docker/volumes/[你的YaCy卷]/_data/SETTINGS/yacy.conf
   

3. 配置pkcs12相关属性：

   pkcs12ImportFile=/opt/yacy_search_server/DATA/SETTINGS/[你的证书].pkcs12
   pkcs12ImportPwd=你的密码
   

后续启动

前台启动

bash
docker start -a yacy

后台启动

bash
docker start yacy

关闭容器

• 使用管理界面的“Shutdown”按钮。
• 或执行：

  bash
  docker exec [容器名称] /opt/yacy_search_server/stopYACY.sh
  

• 或执行：

  bash
  docker stop [容器名称]
  

升级镜像

1. 获取最新镜像：

   bash
   docker pull luccioman/yacy:latest
   # 或Alpine版本
   docker pull luccioman/yacy:latest-alpine
   

2. 创建新容器（复用旧容器数据卷）：

   bash
   docker create --name [临时容器名] -p 8090:8090 -p8443:8443 --volumes-from=[旧容器名] --log-opt max-size=100m --log-opt max-file=2 luccioman/yacy:latest
   

3. 停止旧容器：

   bash
   docker exec [旧容器名] /opt/yacy_search_server/stopYACY.sh
   

4. 启动新容器：

   bash
   docker start [临时容器名]
   

5. 验证正常后删除旧容器：

   bash
   docker rm [旧容器名]
   

6. 重命名新容器：

   bash
   docker rename [临时容器名] [旧容器名]
   

许可证

查看镜像中软件的许可证信息：https://github.com/yacy/yacy_search_server/blob/master/COPYRIGHT