NppFTP插件需手动或在线安装,配置时须注意协议、端口、密钥格式及权限:Host不加协议头,SFTP端口需核对sshd_config,私钥须为无密码OpenSSH格式,文件编码与服务器权限须匹配。

能连,但必须用 NppFTP 插件,且配置稍有不慎就会卡在“连接中”或报 Connection refused、Authentication failed —— 问题几乎全出在协议选错、端口填错、或密钥没配对上。
安装 NppFTP 插件的两种可靠方式
在线安装最省事,但依赖插件管理器(Plugin Manager)是否已启用;若失败,直接手动装更稳:
- 去 SourceForge 下载最新版
NppFTP.dll(地址:https://www.php.cn/link/2bf8d1a826659708a87d010f056ef59c) - 把
NppFTP.dll放进 Notepad++ 安装目录下的plugins文件夹(不是plugins\NppFTP子目录) - 重启 Notepad++,菜单栏出现
NppFTP项才算成功
Profile settings 里最容易填错的三个字段
点 Show NppFTP Window → 齿轮图标 → Profile settings → Add new 后,右侧必填项中:
-
Host:只填域名或 IP,**不要加ftp://或sftp://**(填了直接连不上) -
Port:FTP 默认21,SFTP 默认22;但阿里云/腾讯云等常改 SFTP 端口为2222或10022,得查服务器/etc/ssh/sshd_config里的Port值 -
Connection type:选FTP还是SFTP决定后续选项——选 FTP 才有“传输模式(主动/被动)”,选 SFTP 则跳过这步,直接走密钥或密码认证
SFTP 密钥登录失败的典型原因
如果服务器禁用了密码登录(PasswordAuthentication no),只认密钥,那必须配对私钥文件:
- 在 Profile 的
Advanced标签页勾选Use SSH key authentication -
Private key file必须是 OpenSSH 格式(.ppk不行),用 PuTTYgen 转换时选 “Export OpenSSH key” - 私钥不能有密码保护(即导出时不设 passphrase),否则 NppFTP 会静默失败,无提示
- 确认服务器上
~/.ssh/authorized_keys里已写入对应公钥,且权限为600
连接后双击文件打不开?先看编码和权限
连上能看到目录,但双击文件空白或乱码,大概率是这两件事没做:
- Notepad++ 默认用
ANSI编码打开远程文件,而 Linux 文件多为UTF-8;右键文件 →Encoding → Convert to UTF-8再保存 - 如果提示
Permission denied,不是插件问题,是服务器上该文件没有读权限(ls -l看是否含r);编辑后保存失败,则可能是目录无写权限或磁盘满 - 别忽略
Advanced里的Initial remote directory:填上/var/www/html这类路径,能避免每次连上都从/开始翻
真正麻烦的从来不是“怎么连”,而是连上之后文件打不开、改不了、存不回——编码、权限、路径三者漏一个,就卡住不动。SFTP 密钥路径和私钥格式尤其容易被当成“小细节”跳过,结果花半小时查日志才发现是 .ppk 文件不兼容。

















