Nagios中文显示问题的解决方案

admin

Nagios的Status Map功能链接能够显示被监控的网络拓扑图，并在节点图片上面显示节点设备名。遗憾的是，默认的Nagios不支持中文。为此我研究了两天Nagios以及GD的源代码，终于找到了解决方案，详述如下：

解压缩Nagios中文源代码包（以nagios-3.0.3为例），实现绘制网络拓扑图的源代码文件是nagios-3.0.3/cgi/statusmap.c，编译安装后，这个文件对应nagios/sbin/statusmap.cgi，当你在Nagios中文运行界面点击左侧的“Status Map”链接时，服务器（apache、tomcat等支持CGI的服务器软件）调用可执行文件statusmap.cgi，实现在浏览器客户区中绘制网络拓扑图。

statusmap.c中负责绘制节点设备名的函数是void draw_text(char *buffer,int x,int y,int text_color)，就在本文件中定义，它调用GD的一个库函数——
gdImageString(map_image,gdFontSmall,x-(string_width/2),y-(2*string_height),(unsigned char *)buffer,text_color);来绘制节点设备名。

这里先简单介绍一下GD以及其他一些软件与Nagios的关系。Nagios处理图片（包括绘制文字）需要借助于GD，有些版本的Linux已经集成了GD，所以可以直接安装使用Nagios。安装GD以及相关的软件包的顺序如下（版本仅为举例）：
4 W& {- ^  f/ s; [* G7 L7 D% c% T8 kgd：一个处理图片（包括绘制文字）的软件包；
& |" t+ _/ \  ~" x2 R  k5 s1 Sfreetype：gd解析字库用到的软件包；
: J; Z' m7 t# P- U- p+ |4 ?& [libpng：gd解析png图片用到的软件包；
( I: n+ \, Q6 h  e5 u1 |( \# X0 f- yjpeg：gd解析jpeg图片用到的软件包。

安装方法举例：

安装方法
+ S/ r& |) }2 l安装freetype
/ n7 w, V  u- \$ Q! T" z#cd /data/software
7 p- U  j3 w$ z& X( g* i0 ]! W0 q% n  S+ j#tar xzvf freetype-2.1.5.tar.gz
#cd freetype-2.1.5
#./configure --prefix=/usr/local/modules/freetype
#make
: E2 r- W) \' O4 X0 X7 n* f  ~5 ^#make install

安装libpng
#cd /data/software
0 X7 Z2 J& m/ K#tar xzvf libpng-1.2.5.tar.gz
/ K, ?8 g. x  G0 D1 m#cd libpng-1.2.5
#cp scripts/makefile.std makefile \\不要用--prefix自定义安装目录，影响gd的安装
% c, M) {1 M4 H% @+ T: C#make
3 F6 U6 X$ R: P+ U1 h" V#make install

安装jpeg
- r8 r  z% N) C" b( M#mkdir /usr/local/modules/jpeg6
- F; ?. i# z" S" I; k#mkdir /usr/local/modules/jpeg6/bin
8 n- m7 s- _: B% U#mkdir /usr/local/modules/jpeg6/lib
" P5 @& I% u# [3 k6 {8 f+ z0 M4 j#mkdir /usr/local/modules/jpeg6/include
#mkdir /usr/local/modules/jpeg6/man
3 ^8 c' h" i) B( k" ]7 X2 h( O#mkdir /usr/local/modules/jpeg6/man/man1
" F. O% }% U* {- s#cd /data/software
$ H" I8 f7 P* H#tar xzvf jpegsrc.v6b.tar.gz
7 t  d3 d/ J# F3 ~1 k# b$ F#./configure --prefix=/usr/local/modules/jpeg6 --enable-shared --enable-static
#make
#make install

安装gd
9 K2 d% B! W1 a8 a- R4 t$ a% ]#cd /data/software
#tar xzvf gd-2.0.33.tar.gz
/ R" l- }) m+ t9 U( L: o#./configure --prefix=/usr/local/modules/gd --with- jpeg=/usr/local/modules/jpeg6 --with-png --with-zlib --with-freetype=/usr/local/modules/freetype
#make
/ u9 g) p* c" [3 _8 }, k#make install

最后，在安装nagios时#./configure步骤加一组参数：--with-gd-lib=/usr/local/modules/gd/lib

原始的Nagios中文版不能绘制中文字符串，与GD的字库处理方式有关。GD有自己的字库文件（点阵形式、ASC码编码）。gdImageString的第二个参数即GD自己的字库的索引，第五个参数则是一个ASC编码的字符串。而GD自己的字库是不支持中文的。显然，大名鼎鼎的GD不可能只支持自己的字库，他用函数gdImageStringFT来支持用外部字库绘制utf-8编码的字符串，这里面包含了中文的支持。

gdImageStringFT (gdImage * im, int *brect, int fg, char *fontlist,double ptsize, double angle, int x, int y, char *string)，函数名中的“FT”就是freetype的意思，这个函数通过调用freetype包，支持解析.ttf格式（ttf是TrueType Font的缩写）的字库文件，只要找到Linux下的中文字库的位置，作为第四个参数传给该函数，并且保证char *string是utf-8编码，就能顺利绘制中文字符串。在我的调试环境下，修改如下：
原函数：
5 J6 `  \- h, _, _  RgdImageString(map_image,gdFontSmall,x-(string_width/2),y-(2*string_height),(unsigned char *)buffer,text_color);
* D  g: ?: g+ W, M: Y修改后：
$ M( W( l5 s( g$ [0 ^; fgdImageStringFT(map_image,&brect[0],text_color,"/usr/share/fonts/zh_CN/TrueType/gbsn00lp.ttf",10,0.0,x-(string_width/2),y-(2*string_height),buffer);
（gdImageString和gdImageStringFT详细的功能和参数说明见GD安装包下的说明文档index.html）

由于Nagios是从配置文件中读取设备名字符串然后绘制到屏幕上，所以如果配置文件本身是utf-8编码，如上修改后，重装Nagios就可以顺利显示了。如果配置文件不是utf-8，那么可以通过两种方法解决：

第一种：将配置文件转成utf-8编码。这样不用再度修改源码，但个人不赞成这种方法，理由是：由于Nagios的CGI是用C写的，而C是基于ASC编码的，Nagios又没有借助第三方数据库，而是依赖于读写自己创建的大量配置文件和日志文件，其中用到很多基于ASC编码的字符串处理函数，虽然都是英文的，而英文的ASC编码和utf-8完全相同，但是如果将Nagios的相关文件都转成utf-8编码，可能会导致一些潜在的问题。

第二种：在gdImageStringFT之前加一个字符串编码转换函数，将读入的非utf-8编码字符串buffer转换成utf-8编码，再传给gdImageStringFT处理。这样的字符串编码转换函数网上有很多资源，在此限于篇幅不详述。