安装EZproxy
5.6
GA for Windows
本文档描述如何安装EZproxy 5.4.1 GA for Windows。如果您从一个旧版本EZproxy升级，请参考更新说明。
EZproxy的Linux、Solaris和Windows版本之间的唯一功能差异是：
- Windows版本支持通过Windows domain验证用户。
- Windows版本支持通过ODBC数据源验证用户。
- Solaris 10 (x86)版本不支持Athens认证。
程序下载的链接在安装说明中提供。
概述
EZproxy是一个易于安装、易于维护的程序，为用户提供远程访问基于web的许可数据库的服务。EZproxy在用户和许可数据库之间起到中介服务器的作用。用户先连接到EZproxy，然后EZproxy代表用户连接到许可数据库获取网页并将其发送回给用户。由于EZproxy是在您机构网络内的一个机器上运行，因此您的数据库供应商将EZproxy发来的请求认作是来自您网络内的一个IP地址的，因此允许其访问。
假设ezproxy.yourlib.org是您的EZproxy服务器，同时您订购了somedb.com数据库，您就可以在config.txt编辑，添加：
Title Some Database
URL http://somedb.com/search/
Domain somedb.com
这样，这个数据库就可以从任何web服务器访问，使用类似的URL：
<a href="http://ezproxy.yourlib.org:2048/login?url=http://somedb.com/search">Some Database</a>
如果是在机构IP范围的用户点击上述URL，那么他们将直接进入数据库；如果用户是来自机构IP范围外，则会被带到认证界面。一旦认证成功后，远程用户就能通过一个“虚拟web服务器”访问数据库。
当一个用户远程访问ezproxy.yourlib.org并请求访问somedb.com，EZproxy会自动为somedb.com创建一个虚拟web服务器。在这个例子中，http://somedb.com可能被分配到一个名为http://ezproxy.yourlib.org:2050的web服务器。所有虚拟web服务器使用相同的命名规则，使用不同端口（如2050）区分它们。
当这个用户通过这个虚拟web服务器请求文档，EZproxy将向somedb.com发出同样的请求，并将响应发送回给此用户。在这个通信中，因为请求是从您自己的服务器发出，因此somedb.com将它视为来自您机构的一个IP地址因而允许它访问。
功能与权利
EZproxy可让远程用户访问数据库。然而，您与数据库供应商的许可协议中可能没有包含向您提供远程访问服务的授权。作为远程访问的实施者，这是您的责任去核实使用许可协议，并只有在获得授权的前提下才能允许远程访问。
系统要求
EZproxy在Windows 7、2000、2003、2008、XP、XP Professional的所有版本上都可以运行。
Windows服务器的最低推荐配置：Pentium II 400、256 MB内存、10 MB硬盘空间供安装，有额外的硬盘空间供保存用户认证文件和服务器日志文件。
这个程序可以由一个非特权账号执行，因此请考虑由一个非管理员账号运行它。
如果您的站点为所有对外连接因特网都部署了一个代理服务器，您将需要在config.txt文件里输入这个代理服务器的host和port信息，从而使用Proxy指令。
如果您的站点受防火墙保护，外部用户可能无法连接到EZproxy，除非防火墙管理员允许向2048及以上端口传入通信。
用户认证
EZproxy提供多种方式进行用户认证。欲了解这方面更多信息，请参见用户认证。
EZproxy文件
EZproxy使用以下文件：
| 文件名 |
用途 |
| ezproxy.exe |
该文件是EZproxy安装程序。 |
| config.txt |
此用户可编辑文本文件包含配置指令，包括许可数据库的信息。在EZproxy 5.0及之前版本，该文档被命名为“ezproxy.cfg”。 |
| user.txt |
此用户可编辑文本文件包含用户认证信息。简单地说，这个文件包含用户名和密码。在EZproxy 5.0及之前版本，该文档被命名为“ezproxy.usr”。 |
| ezproxy.log |
此文本文件记录了NCSA Web服务器日志文件格式的代理服务器使用情况。如果使用标准的Web日志分析软件，该文件可以提供关于远程使用情况的信息。 |
| messages.txt |
此文本文件记录当EZproxy运行时发生的特定信息和错误情况。在EZproxy 5.0及之前版本，该文档被命名为“ezproxy.msg ”。 |
| ezproxy.hst |
此文本文件包含了活跃用户和虚拟web服务器代理的信息。 |
| license.txt |
此文本文件是这个程序的授权协议。 |
| *** 下列用户可编辑的HTML文件位于docs子目录。 *** |
| cookie.htm |
EZproxy使用一个基于domain的cookie作为其正在进行的已验证用户的认证。如果远程用户的cookie不被允许，此文件的内容将被发送出去来解释为什么需要使用cookie。 |
| login.htm |
当内置的用户验证功能启用时，这个网页将被发送给远程用户以进行身份验证。 |
| loginbu.htm |
如果用户无法成功地在login.htm页面验证，这个页面将发送给用户。 |
| logout.htm |
当用户从EZproxy登出，这个页面将发送确认登出。 |
| menu.htm |
此页面提供一个数据库基本菜单。在大多数情况下，这个文件仅用于测试目的。正式投入使用时，您更愿意在远程文件里创建类似http://ezproxy.yourlib.org:2048/login?url=http://somedb.com这样的URL，用户通过这个可连接到远程数据库。请参见LoginMenu。 |
您只需下载ezproxy-win32.exe，所有其他文件在安装过程中会自动生成。
在Windows系统的EZproxy安装说明
EZproxy是一个完全独立的应用程序。它不需要也不使用任何已经安装在您服务器上的现有Web服务器。
如果您已在运行EZproxy的系统上运行了一个Web服务器，不要试图在Web服务器已经使用过的目录内安装EZproxy。
如果您正在运行IIS，不要在inetpub目录内安装EZproxy，也不要试图在IIS Manager内为EZproxy配置一个Web服务器。
- 打开“命令提示符”窗口（「开始」→「运行」→输入
cmd
点击「确定」
- 为EZproxy创建一个文件夹，输入以下命令：
c:
md \ezproxy
cd \ezproxy
- 下载 ezproxy-win32.exe 至这个文件夹。
- 将ezproxy-win32.exe重命名为“ezproxy.exe”，使用以下命令：
rename ezproxy-win32.exe ezproxy.exe
- 创建前文提及的多数文件的默认版本，使用下面命令：
ezproxy -m
“-m”代表“丢失文件替换”，这命令可以在任何时间用来重建任何丢失文件，但不会覆盖您已经做过修改的现有文件。
- 如果在Windows XP Service Pack 2安装EZproxy ，参照“Windows防火墙在Windows XP Service Pack 2”文档中的步骤来配置Windows防火墙。
- 为了验证EZproxy是否能准确自动监测到您的host name，以及检查防火墙是否会干扰您使用EZproxy，请输入命令：
ezproxy -c
此命令将使您服务器连接到OCLC服务器。您服务器将自动提供其名字和IP地址，OCLC服务器将尝试验证这些信息。您服务器将会显示各种信息，以便告知您为了正常使用EZproxy而需要做的修改。
如果不希望将您服务器与OCLC服务器连接，就省略这个步骤。
如果您网络要求通过一个标准代理服务器连接因特网，此测试将失败。在这种情况下，需要配置EZproxy运用Proxy指令来使用您的对外代理服务器，您需要先完成EZproxy安装，接着使用安装在同一个服务器上或者在您网络内的一个网络浏览器访问EZproxy Administration页面（在该页面可以使用Test network connectivity 选项），接着您就能完成网络连接测试。这将是一个更加彻底的网络测试，包括提供对您的对外代理服务器的测试选项。
- 使用一个文本编辑器编辑config.txt文件。如果按照上文的步骤操作，在该文件中手动指定您的host name。该文件还包含了对其他修改的建议。
- 使用一个文本编辑器编辑user.txt文件。在这个文件，添加一行话，类似：
someuser:somepass:admin
将 someuser 改成用于测试的用户名，把 somepass 改成用于测试的密码。在这个例子里，admin就如上面一样，不需做修改。
- 启动服务器，使用命令：
ezproxy
- 使用网络浏览器，连接您服务器2048端口。如果EZproxy服务器被命名为ezproxy.yourlib.org。您需要使用这个URL：
http://ezproxy.yourlib.org:2048/admin
-
登陆到Admin界面，输入您在user.txt文件中所创建的用户名和密码，就会连接到主服务器的管理页面。
如果看到的不是菜单页面，您应该会看到一个页面显示EZproxy cookie被拦截。如果遇到这种情况，请参见“EZproxy Cookie被拦截”页面查看发生这种情况的原因以及解决方案。
工作性能取决于您如何定制config.txt。如果您对config.txt做了修改，您需要重新启动EZproxy，这样所作的修改才能生效。
重置所有文件
如果您想将所有文件重置为原始文件，可以输入以下命令：
ezproxy -r
如果您想恢复1或2个原始文件，重命名或删除您需要替代的现有文件，然后输入以下命令：
ezproxy -m
作为一个Windows service安装
作为一个Windows service安装EZproxy，让它在系统启动时就运行，所需的配置步骤请参见配置EZproxy作为一个Windows Service运行。
下一步
现在EZproxy开始运行了，您需要继续查看用户认证部分以了解如何创建从EZproxy服务器连接到每个数据库的URL，以及如何设置符合您环境的用户认证。
技术细节
如果您对EZproxy的技术细节好奇，请查看EZproxy技术细节。
馆员工具箱:
