# CPAN

> 可调整选项：
> - 镜像地址：`https://mirrors.cernet.edu.cn/CPAN`
> - sudo：`开启`


> 本站收录所有共享帮助文档；文档存在不代表浙江大学镜像站当前提供该镜像。请查阅 https://mirrors.zju.edu.cn/mirrorz.json 确认当前目录与状态。
> 下列命令使用上述选项，请根据实际系统版本选择；未填写的文本选项需要在原文页面补充。

## 使用方法

[CPAN](<https://www.cpan.org/>) (The Comprehensive Perl Archive Network) 镜像源的配置文件为 `MyConfig.pm`（一般位于 `~/.cpan/CPAN/MyConfig.pm`），可使用包管理脚本 `cpan` 进行修改。

### 初次使用

如果 `MyConfig.pm` 配置文件不存在，在命令行中执行：

```bash
# 自动生成 MyConfig.pm
## 对于 Perl 5.36（或 CPAN 2.29）及以上，使用如下命令
PERL_MM_USE_DEFAULT=1 perl -MCPAN -e 'CPAN::HandleConfig->edit("pushy_https", 0); CPAN::HandleConfig->edit("urllist", "unshift", "https://mirrors.cernet.edu.cn/CPAN/"); mkmyconfig'
## 对于较久版本，使用如下命令
PERL_MM_USE_DEFAULT=1 perl -MCPAN -e 'CPAN::HandleConfig->edit("urllist", "unshift", "https://mirrors.cernet.edu.cn/CPAN/"); mkmyconfig'

# 或不使用默认配置，手动确认各个配置选项
perl -MCPAN -e 'mkmyconfig'
```

### 已有配置

#### 在 CPAN Shell 中手动设置镜像

在命令行中执行 `cpan` 进入 cpan shell：

```console
cpan shell -- CPAN exploration and modules installation
Enter 'h' for help.

# 列出当前的镜像设置
cpan[1]> o conf urllist

# 将本站镜像加入镜像列表首位
# 注：若已在列表中则可跳过本步直接退出，修改列表不会执行自动去重
cpan[2]> o conf urllist unshift https://mirrors.cernet.edu.cn/CPAN/

# 或将本站镜像加入镜像列表末尾
# 注：本命令和上面的命令执行一个即可，修改列表不会执行自动去重
cpan[3]> o conf urllist push https://mirrors.cernet.edu.cn/CPAN/

# 或清空镜像列表，仅保留本站
cpan[4]> o conf urllist https://mirrors.cernet.edu.cn/CPAN/

# Perl 5.36 及以上用户需要关闭 pushy_https 以使用镜像站
cpan[5]> o conf pushy_https 0

# 保存修改后的配置至 MyConfig.pm
cpan[6]> o conf commit

# 退出 cpan shell
cpan[7]> quit
```

#### 在命令行中使用脚本设置

在命令行中执行：

```bash
# 若本站不在镜像列表中则将其加入列表首位
if ! (
    perl -MCPAN -e 'CPAN::HandleConfig->load();' \
        -e 'CPAN::HandleConfig->prettyprint("urllist")' |
    grep -qF 'https://mirrors.cernet.edu.cn/CPAN/'
); then
    perl -MCPAN -e 'CPAN::HandleConfig->load();' \
        -e 'CPAN::HandleConfig->edit("urllist", "unshift", "https://mirrors.cernet.edu.cn/CPAN/");' \
        -e 'CPAN::HandleConfig->commit()'
fi

# Perl 5.36 及以上用户还需要关闭 pushy_https
perl -MCPAN -e 'CPAN::HandleConfig->load();' \
    -e 'CPAN::HandleConfig->edit("pushy_https", 0);' \
    -e 'CPAN::HandleConfig->commit()'
```


## pkgsrc

本节供 [pkgsrc 帮助](<https://mirrors.zju.edu.cn/docs/pkgsrc/>)使用

```
MASTER_SITE_PERL_CPAN= https://mirrors.cernet.edu.cn/CPAN/modules/by-module/
```

---

许可：[CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)
文档索引：https://mirrors.zju.edu.cn/llms.txt
如仅限浙大校内网络访问，可将 mirrors.cernet.edu.cn 替换为 mirrors.zju.edu.cn。